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PREFACE 


This  user's  manual  covers  the  work  performed  under  Air 
Force  Contract  F3S615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory.  Air  Force 
Systems  Command.  Wright-Pat terson  Air  Foroe  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  Mew  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Eleotric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  Mew  York. 


Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 


Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

D.  Appleton  Company 
( DAOOM ) 


General  Dynamics/ 
Ft.  Worth 


iii 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  and  information 
mode 1 s . 
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Subcontractors 

/ 

Illinois  Institute  of 
Technology 

Worth  Anerioan  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Conpany  (BMAC) 

Conputer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(CDC) 


D.  Appleton  Conpany 
( DACOM ) 


Role 

Responsible  for  factory  view 
funotion  research  (IITRI) 
and  infornation  nodels  of 
snail  and  medium-sise  business. 

Reviewer. 

Responsible  for  factory  view 
function  and  infornation 
nodels. 

Responsible  for  IDEF2  support. 
Responsible  for  IDEPO  support. 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  conputer  technology. 

Assisted  in  the  areas  of 
connuni oat ions  systens.  systen 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Connon  Data 
Model  (CIB1)  iaplenentation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsysten  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schena 
mappings  for  the  Application 
Subsystems . 


Role 
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Subcontractors 

Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
Internet i onal  ( OSI ) 


Role 

Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  MoCormaok  9  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military  1701. 
Aircraft  Company  2202 
(BMAC) 


2201 .  Enhancements  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) . 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502.  1701 

IISS  enhanceaents  to 
Coaaon  Data  Model 
Processor  (CDMP). 

D.  Appleton  Coapany 
(DACOM) 

1502 

IISS  enhanceaents  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  coaauni cat ions 
equipaent . 

Hughes  Aircraft 

Coapany  (HAC) 

1701 

Test  Bed  enhanoeaents . 

Structural  Dynaaics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhanceaents  to 
User  Interface/Virtual 
Terainal  Interface 
(UI/VTI) . 

Systran 

1502 

Test  Bed  enhanceaents . 
Operation  of  Test  Bed. 
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SECT10M  1 
INTRODUCTION 


The  Heutral  Data  Definition  Language,  hereafter  MDDL,  is  an 
interpretive  language  that  was  developed  to  populate  and 
maintain  the  Common  Data  Model  database  (CDM1  Doc.  Control 
No . -CCS  620141000).  As  the  MDDL  is  intended  to  be  used  by  data 
processing  professionals  who  are  experts  with  various  data  base 
management  systems,  a  discussion  of  data  base  management  systems 
is  not  included  in  this  document  (see  CDM  Administrators  Manual 
Doc.  Control  Mo.  UM  620141000).  Furthermore,  an  understanding 
of  the  CDM  database  is  necessary. 

The  CDM  Database  uses  a  Three-Schema  approach  based  upon 
"The  AMSI/X3/SPARC  DBMS  Framework:  Report  of  the  Study  Group  on 
Data  Base  Management  Systems”.  In  the  IISS,  the  Three-Schema 
Architecture  is  implemented  through  the  CDM  facilities  to  store 
each  of  the  three  types  of  schemas  and  the  interschema  mappings. 
The  MDDL  supports  the  population  and  maintenance  of  appropriate 
representations  for  each  of  the  three  types  of  schemas. 

The  conceptual  schema  is  represented  by  an  IDEF-1  model . 

The  CDM  stores  this  model  in  terms  of  entity  classes,  attribute 
classes,  and  relation  classes. 

The  external  schemas  are  represented  by  tables.  The 
mappings  between  these  tables  and  the  IDEF-1  model  of  the 
conceptual  schema  are  part  of  the  CDM  database. 

The  internal  schemas  are  represented  in  terms  of  physical 
database  components,  including  record  types  and  inter-record 
relationships . 

Section  2  of  this  manual  is  a  discussion  of  how  to 
interface  with  the  NDDL  processor  and  the  NDDL  syntax  which  is 
similar  to  that  of  the  Neutral  Data  Manipulator  Language  (see 
NDML  Guide  PRM  620141200). 

Actual  NDDL  commands  are  explained  in  Section  3  which  is 
followed  by  NDDL  Command  Error  Messages  which  are  listed  in 
Appendix  A. 

Appendix  B  is  a  Glossary  of  the  more  important  terms  used 
in  this  guide  and  is  followed  by  a  list  of  references. 
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SECTION  2 
OVERVIEW 


2.1  NDDL  ENVIRONMENT 

NDDL  can  be  executed  fro*  three  environments  within  IISS: 
batch  environment 

interactive  environment  without  the  IISS  User 
Interface/Virtual  Terminal  Interface  (UI/VTI) 
interactive  environment  with  the  IISS  User 
Interface/Virtual  Terminal  Interface  (UI/VTI) 

The  environment  is  determined  from  the  users  response  to  the 
"args"  prompt  upon  NDDL  activation  as  depicted  below. 

2.1.1  Batch  Environment 


args:  <  file  specification  >  file  specification 

<  file  specification  -  redirect  the  input  for  NDDL  to 
come  from  the  file  specified 

>  file  specification  -  redirect  the  output  for  NDDL  to 
be  written  to  the  file  specified 

file  specification  -  DISK_NAME  /UFD/SFD/FILE .EXTENSION 

Example: 

args :  < NDDL .INF  >  NDDL . OUT 

NDDL.INP  is  a  file  containing  NDDL  commands. 

Note : 

This  file  name  must  follow  the  Unix  standard 
for  naming  files,  not  that  of  the  host  operating 
system. 

2.1.2  Interactive  Environment  (without  IISS  UI/VTI) 
args:  (carriage  return) 

The  NDDL  "NEXT  COMMAND"  prompt  will  be  displayed,  at  which  time 
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the  user  may  enter  any  valid  NBDL  co— and . 

Example: 

args:  (carriage  return) 

MEET  COMMAND — 

CREATE  MODEL  testmodel ; 

—COMMAND  SUCCESSFUL- 
NEXT  COMMAND- 
HALT; 

2.1.3  Interactive  Environment  (with  I1SS  UI/VTI) 
args : -I 

The  NDDL  form  will  be  displayed,  at  which  time  the  user  may 
enter  NDDL  commands.  A  description  of  the  form  and  how  it  is 
used  for  NDDL  is  contained  in  the  next  section  of  this  document 
"Using  the  NDDL  Form." 

2.2  Using  the  NDDL  Form 

This  section  describes  the  use  of  the  NDDL  form.  The  form 
manipulations  are  supported  by  the  IISS  User  Interface/Virtual 
Terminal  Interface  (UI/VTI)  software.  This  section  will  also 
describe  the  detailed  forms  procedures  unique  to  the  NDDL 
application.  For  general  information  regarding  forms  use.  refer 
to  the  IISS  UI/VTI  Terminal  Operator's  Guide. 


2.2.1  NDDL  Form  Description 

The  NDDL  form  appears  immediately  following  NDDL 
activiation  with  the  -I  parameter  as  explained  in  the  "NDDL 
Environment"  section.  A  description  of  the  individual  fields 
fol lows . 

Field  1  -  Current  Model  Field 

This  field  displays  the  current  model  name.  The  current 
model  field  is  modified  each  time  a  CREATE  MODEL  or  ALTER 
MODEL  command  is  successfully  executed.  If  neither 
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command  has  been  executed  in  a  session,  the  "MOT  YET 
SPECIFIED"  Message  will  appear  in  this  field. 

Field  2  -  Current  Database  Field 

This  field  displays  the  current  database  name .  The 
current  database  field  is  modified  each  time  a  DEFINE 
DATABASE,  DEFINE  SET,  or  DEFINE  RECORD  cososand  is 
successfully  executed.  If  none  of  the  ooam&nds  have  been 
executed  in  a  session,  the  "NOT  TET  SPECIFIED"  message 
will  appear  in  this  field. 

Field  3  -  NDDL  Command  Field 

This  is  the  field  in  which  NDDL  commands  are  entered. 

This  field  is  78  columns  wide  and  100  lines  long  and  is 
viewed  3  lines  at  a  tine.  This  field  may  be  paged  and 
scrolled  as  described  in  the  IISS  UI/VTI  Terminal 
Operator's  Guide. 

Field  4  -  Message  Area 

This  field  displays  NDDL  error  and  informative  messages. 
The  message  area  is  30  lines  long  and  is  viewed  3  lines  at 
a  time.  This  field  may  be  paged  and  scrolled  as  described 
in  the  IISS  UI/VTI  Terminal  Operator's  Guide. 

Field  5  -  Message  Line  Number  Field 

The  message  line  number  field  serves  two  purposes.  It  is 
used  to  display  the  number  of  the  message  displayed  in 
field  6,  the  message  line.  The  message  line  number  is 
also  used  to  select  a  particular  message  in  field  6  for 
viewing.  The  user  can  position  the  cursor  to  this  field, 
enter  a  number  from  01  to  99  and  read  the  corresponding 
message,  assuming  one  exists. 

Field  6  -  Message  Line 

The  message  line  is  99  lines  long,  viewed  one  line  at  a 
time.  This  field  may  contain  informative  and  error 
messages  which  overflow  field  4.  In  addition,  this  field 
will  contain  summary  messages  indicating  whether  or  not 
errors  have  occurred  and  the  number  of  generated  messages . 
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2.2.2  Form  Use 
VT100  Keypad 

The  VT100  keypad  is  depicted  in  Figure  2-1.  The  keys  which 
apply  uniquely  to  NDDL  are: 

pf4  -  Press  pf4  to  terminate  NDDL .  This  key  forces  an 

NDDL  HALT  oomm&nd,  freeing  the  user  from 
explicitly  entering  the  HALT. 

enter  -  Press  enter  to  initiate  execution  of  the  entered 

■DDL  command(s).  After  the  oommands  are 
executed  or  syntax  checked,  the  form  reappears. 
If  an  error  was  encountered,  all  commands 
reappear  along  with  their  error  messages.  If, 
however,  no  errors  are  encountered,  the  commands 
do  not  reappear  when  the  form  is  repainted. 

0  (pf 16)  -  Press  0  to  initiate  execution  of  the  entered 

■DDL  oommand(s).  After  the  oommands  are 
executed  or  syntax  ohecked,  the  form  reappears 
with  the  previously  entered  commands  showing 
whether  or  not  error  occurred.  This  feature  is 
intended  to  be  used  when  the  user  has  a  number 
of  similar  commands  to  exeoute.  The  user  need 
only  modify  that  dynamic  portion  of  the  command 
for  each  subsequent  execution. 

All  other  keypad  keys  operate  as  described  in  the  UI/VTI 
Terminal  Operator's  Guide.  In  addition,  there  are  a  number  of 
non-keypad  keys  that  manipulate  the  form  and  are  described  in 
the  same  document. 

2.2.3  NDDL  Command  Entry 

All  NDDL  commands  must  be  entered  in  the  NDDL  command  field 
with  syntax  as  described  in  the  "NDDL  Commands"  section  of  this 
document.  The  terminating  semicolons  are  mandatory  for  all 
commands.  The  user  may  enter  as  many  complete  commands  as  may 
be  contained  in  100  lines.  After  execution  has  started,  the 
form  will  not  reappear  until  all  commands  have  executed  or  had 
their  errors  diagnosed. 
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l - 1 - 1 - 1 - 

Ipf 1  I  pf2  i  pfS  I  pf4 

I  GOLD  i  help  l  debug  l  quit 

II  II  HALT 

I - 1 - 1 - 1 - 

17  (pf5  I  8  (pf6)  I  9  (pf?)  I  -  (pf 8) 

I  scroll  I  scroll  I  scroll  l  scroll 

I  left  i  right  I  up  I  down 

l - 1 - 1 - 1 - 

14  (pf9)l  5  (pflO)  I  6  (pfll)  l  ,  Cpf 12) 

l  P&ge  I  page  t  page  l  page 

I  left  l  right  l  up  l  down 

I  - 1 - 1 - 1 - 

1 1 ( pf 13)1  2  (pf 14 )  I  3  ( pf 15)  I  enter 

II  II  Execute  MDDL 

II  li  connands  - 

I - 1 - 1 - 1  redisplay  the 

10  (pf  16)  I  .  (pf  17)  I  couands  only 

l Execute  NDDL  connands  l  i  if  errors 

(redisplay  the  coaaandsi  l  encountered 

I  unconditionally  I  l 

I - 1 - 1 - 

Figure  2-1.  VT100  Function  Keypad 
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2.2.4  Error  Message  Reporting 

After  a  fora  of  commands  has  executed,  error  messages  may 
or  nay  not  appear.  If  no  errors  have  occurred,  a  "no  errors 
encountered"  message  will  appear  in  the  me s save  line  of  the 
form.  If  errors  have  occurred,  a  "coaaand(s)  completed  -  n 
error  messages”  message  will  appear  with  n  equal  to  the  number 
of  messages  generated.  Vote  that  a  particular  command  may 
generate  many  error  messages.  The  message  area  aay  contain  up 
to  30  messages,  displayed  3  messages  at  a  time.  Should  there  be 
more  than  30  messages  generated,  the  final  line  of  the  message 
area  will  contain  the  following  message:  PLEASE  REFER  TO  THE 
MESSAGE  LIME  FOR  REMAIMIMG  MESSAGES.  Since  the  message  line 
indicates  that  there  were  n  messages  generated  and  since  30 
messages  are  contained  in  the  message  area,  (n-30)  messages 
remain  to  be  viewed  in  the  message  line.  Position  the  cursor  to 
the  message  line  number  field  (field  4),  key  in  01  and  press 
enter  for  the  first  message.  For  each  subsequent  message, 
increment  field  4  by  one  and  press  enter. 

If  many  commands  have  been  entered  and  errors  were 
encountered,  all  commands  preceding  the  erroneous  command  will 
have  exeouted,  applying  their  specified  database  modifications. 
The  erroneous  command  and  all  subsequent  commands  in  the  same 
fora  will  not  execute.  The  commands  following  the  erroneous 
command  on  the  same  form  will  be  syntax  checked  only. 

To  assist  in  matching  the  error  messages  with  the  proper 
NDDL  commands,  the  following  messages  are  generated: 

— COMMAND  SUCCESSFUL—  -  The  command  has 

successfully  executed. 


— HO  CHANGE  MADE —  -  Errors  were  encountered. 

The  detailed  error  messages 
which  apply  to  this  message 
precede  i t . 

— COMMAND  SYNTAX  CORRECT —  -  An  error  in  a  previous 

NDDL  command  caused  all 
subsequent  commands  in  the 
form  to  be  syntax  checked 
only . 
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— INVALID  SYNTAX —  -  The  command  syntax  is 

incorrect . 

For  example,  if  five  ” — COMMAND  SUCCESSFUL — "  messages  are 
generated  before  the  first  error  message  appears,  the  offending 
NDDL  command  is  the  sixth  one  on  the  form. 

2.3  NDDL  COMMAND  SYNTAX 


In  the  syntactic  description  of  the  NDDL  commands,  the 
following  symbols  are  used: 

[  ]  indicates  an  optional  word  or  phrase 
{  }  indicates  a  choice  of  only  one  word  or  phrase 
...  indicates  repetition  of  the  last  element 
:  indicates  the  end  of  a  command  and  must  be  entered  by 

the  user 

i  indicates  a  choice  of  options 

All  uppercase  words  must  be  specified  as  indicated;  lowercase 
words  indicate  a  user-defined  variable  which  the  user  may  fill 
in  with  uppercase  or  lowercase  letters.  Lowercase  word6  are 
case  sensitive,  e.g.,  variable  XYZ  is  not  the  sane  as  variable 
xyz .  The  user  may  enter  any  string  of  up  to  30  characters  for 
lowercase  words.  These  characters  nay  be  any  combination  of 
letter,  digit,  dash,  or  underscore 

Comments  may  be  embedded  by  surrounding  the  comment  with  /* 
and  * / . 

Most  repetitions  are  separated  by  a  single  blank  space; 
however,  a  few  commands  must  be  separated  by  commas. 


2.4  NDDL  RESERVED  WORDS 


Following  is 

a  list  of  NDDL 

reserved 

words .  These  words 

cannot  be  used  as 

a  user-defined 

variable 

in  any  NDDL  command 

ACCESSED 

FILES 

PCB 

ADD 

FLOAT 

POSITION 

ALIAS 

FROM 

PRIMARY 

ALTER 

HALT 

PSB 

AND 

HL6 

RECORD 

AREAS 

HOST 

RELATING 

AS 

IBM 

RELATION 

ATTRIBUTE 

IDMS 

RENAME 

BY 

IDS  II 

REQUIRED 
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CHARACTER 

IMS 

ROLLBACK 

(!H|yat 

IE 

S 

CLASS 

IETEGER 

SCHEMA 

COLUMNS 

IETO 

SECOND 

COMBINE 

IS 

SEGMENT 

COMMIT 

ITEM 

SELECT 

COMPARE 

ITEMS 

SET 

COPT 

KET 

SIGNED 

CREATE 

EETEORD 

SIEE 

DATA 

LINKED 

STANDARD 

DATABASE 

LENGTH 

START 

DATAITEM 

MART 

STRUCTURE 

DATAFIELD 

MAP 

SUBSCHEMA 

DECIMAL 

MERGE 

TABLE 

DEFIES 

MIGRATES 

TO 

DESCRIBE 

MODEL 

TOTAL 

DESCRI PTIOM 

NAMED 

U 

DOMAIN 

NUMERIC 

UNKNOWN 

DROP 

OF 

UNSIGNED 

ELEMEETS 

ON 

TYPE 

EETITT 

OPTIONAL 

VALUE 

EXCEPT 

ORACLE 

VAX  11 

EXIT 

OWNED 

VAX 

FEEDBACK 

P 

VIEW 

FIELD 

PACKED 

WHERE 

FIELDS 

PATH 

WITH 

FILE  NAME 

PASSWORD 
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A  cross  reference  between  NDDL  object  types  and  NDDL 
command  is  contained  in  Table  2-1. 

TABLE  2-1 

CROSS  REFERENCE  OF  OBJECT  TYPES  AMD  MDDL  COMMANDS 


OBJECT  TYPE 

NDOL  COMMAND 

ALIAS 

ALTER  ALIAS 

COMBINE  ENTITY 
COPY  ATTRIBUTE 
COPY  ENTITY 
COPY  MODEL 
CREATE  ALA IS 
DROP  ALIAS 
MERGE  MODEL 

AREA  DEFINE  DATABASE 

DEFINE  RECORD 

ATTRIBUTE  CLASS  ALTER  ATTRIBUTE 

ALTER  ENTITY 
ALTER  MAP 
COPY  ATTRIBUTE 
COPY  DESCRIPTION 
CREATE  ALIAS 
CREATE  ATTRIBUTE 
CREATE  ENTITY 
DESCRIBE  ATTRIBUTE 
DROP  ALIAS 
DROP  ATTRIBUTE 
RENAME  ATTRIBUTE 

CARDINALITY  ALTER  RELATION 

CREATE  RELATION 


DATA  ITEM 


CREATE  VIEW 
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CROSS 

OBJECT  TYPE 

DATABASE 

DATA  TYPE 

DESCRIPTION 

DOMAIN 


TABLE  2-1  (Conlinaed) 

REFERENCE  OF  OBJECT  TYPES  AND  NDDL  COMMANDS 


NDDL  COMMAND 


ALTER  MAP 
CREATE  MAP 
DEFINE  DATABASE 
DEFINE  RECORD 
DEFINE  SET 
DROP  DATABASE 
DROP  FIELD 
DROP  RECORD 
DROP  SET 

ALTER  DOMAIN 
ALTER  MAP 
CREATE  DOMAIN 
CREATE  MAP 
CREATE  VIEW 

COMBINE  ENTITY 
COPY  ATTRIBUTE 
COPY  DESCRIPTION 
COPY  ENTITY 
COPY  MODEL 
DESCRIBE  ATTRIBUTE 
DESCRIBE  ENTITY 
DESCRIBE  RELATION 
MERGE  MODEL 

ALTER  DOMAIN 
CREATE  ATTRIBUTE 
CREATE  DOMAIN 
DROP  DOMAIN 
RENAME  DOMAIN 
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TABLE  2-1  (Continued) 

CROSS  REFERENCE  OF  OBJECT  TYPES  AND  HDDL  COMMANDS 


OBJECT  TYPE 


NDDL  COMMAND 


ENTITY  CLASS  ALTER  ENTITY 

ALTER  MAP 
ALTER  RELATION 
COMBINE  ENTITY 
COPY  DESCRIPTION 
COPY  ENTITY 
CREATE  ALIAS 
CREATE  ENTITY 
CREATE  MAP 
CREATE  RELATION 
CREATE  VIEW 
DESCRIBE  ENTITY 
DROP  ALIAS 
DROP  ENTITY 
DROP  MAP 
DROP  RELATION 
RENAME  ENTITY 
ALTER  MAP 
CREATE  MAP 
DEFINE  RECORD 
DEFINE  SET 
DROP  FIELD 


FILE  COMBINE  ENTITY 

COPY  ATTRIBUTE 
COPY  ENTITY 
COPY  MODEL 
DEFINE  DATABASE 
DESCRIBE  ATTRIBUTE 
DESCRIBE  ENTITY 
DESCRIBE  RELATION 
MERGE  MODEL 

KEYCLASS  ALTER  ENTITY 

ALTER  RELATION 
CREATE  ENTITY 
CREATE  RELATION 

KEY  FIELD  DEFINE  RECORD 
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CROSS 

OBJECT  TYPE 

KEYWORD 


MAP 

MODEL 


PASSWORD 


TABLE  2-1  (Continued) 

REFERENCE  OF  OBJECT  TYPES  AMD  NDDL  COMMANDS 


NDDL  COMMAND 


ALTER  ATTRIBUTE 
ALTER  ENTITY 
ALTER  RELATION 
COMBINE  ENTITY 
COPY  ATTRIBUTE 
COPY  ENTITY 
COPY  MODEL 
CREATE  ATTRIBUTE 
CREATE  ENTITY 
CREATE  RELATION 
DROP  KEYWORD 
MERGE  MODEL 
RENAME  KEYWORD 

ALTER  MAP 
DROP  MAP 

ALTER  MODEL 
CHECK  MODEL 
COMBINE  ENTITY 
COMPARE  MODEL 
COPY  ATTRIBUTE 
COPY  DESCRIPTION 
COPY  ENTITY 
COPY  MODEL 
CREATE  MODEL 
DROP  MODEL 
MERGE  MODEL 
RENAME  MODEL 

DEFINE  DATABASE 


PATH 


DEFINE  SET 
DROP  SET 
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TABLE  2-1  (Continued) 

CROSS  REFEREHCE  OF  OBJECT  TYPES  AMD  MDDL  COMMANDS 


OBJECT  TYPE 

NDDL  COMMAND 

PCB 

DEFINE  DATABASE 
DEFINE  RECORD 
DEFINE  SET 

DROP  DATABASE 

DROP  FIELD 

DROP  RECORD 

DROP  SET 

PSB 

DEFINE  DATABASE 

RECORD 

ALTER  MAP 

CREATE  MAP 

DEFINE  RECORD 
DEFINE  FIELD 
DEFINE  SET 

DROP  FIELD 

DROP  RECORD 

RELATION  CLASS 

ALTER  MAP 

ALTER  RELATION 
COPY  DESCRIPTION 
CREATE  MAP 

CREATE  RELATION 
CREATE  VIEW 
DESCRIBE  RELATION 
DROP  MAP 

DROP  RELATION 
RENAME  RELATION 

SCHEMA 

DEFINE  DATABASE 

SEGMENT 

DEFINE  RECORD 

DROP  FIELD 

DROP  RECORD 
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TABLE  2-1  (Contintted) 

CROSS  REFERENCE  OF  OBJECT  TYPES  AND  NDDL  COMMANDS 


OBJECT  TYPE 

NDDL  COMMAND 

SET 

ALTER  MAP 

ALTER  RELATION 
CREATE  MAP 
CREATE  RELATION 
DEFINE  SET 

DROP  SET 

SUBSCHEMA 

DEFINE  DATABASE 

TABLE 

DEFINE  RECORD 
DROP  FIELD 

TAG  NAME 

ALTER  MAP 

ALTER  RELATION 
CREATE  MAP 
CREATE  RELATION 
CREATE  VIEW 

DROP  MAP 

VIEW 

CREATE  VIEW 

DROP  VIEW 

RENAME  VIEW 
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SECTION  3 
NDDL  COMMANDS 


This  section  describes  each  NDDL  couand.  The  syntax  of 
each  command  is  given  followed  by  cowand  semantics  and  command 
examples . 
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3.1  ALTER  ALIAS 


Syntax: 

ALTER  ALIAS  {  ENTITY  ecnamel  [IS]  ec_na*e2 

I  ATTRIBUTE  acnane  1  [IS]  ac_na»e2  } ; 

Consents : 

•  The  following  elements  nust  exist  in  the  Common  Data 
Model : 

entity  or  attribute  with  both  primary  and  alias  names 

•  The  command  switches  the  ourrent  primary  and  the  alias 
names . 

•  The  current  primary  names  are  ec_nanel  and  acnamel ;  the 
current  aliases  are  ec_name2  and  ac_name2. 

Examples : 


ALTER  ALIAS  ENTITY  CUSTOMER  IS  CUST  ; 

ALTER  ALIAS  ATTRIBUTE  ORDER  NUMBER  ORDNO  ; 
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3.2  ALTER  ATTRIBUTE 
Syntax: 

ALTER  ATTRIBUTE  [CLASS]  acname  [DOMAIN  domainname] 
[DROP  KEYWORD  keyword . . . ] 

[ADD  KEYWORD  keyword . . . ] ; 


Comments : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model : 


model 

attribute 

•  ALTER  ATTRIBUTE  [CLASS]  acname 

The  attribute  is  altered  with  one  of  the  options 
specified. 

e  [DOMAIN  domain_name] 

When  a  domainname  is  specified  the  validity  of  the  Domain 
is  checked  and  processing  will  halt  if  it  is  invalid. 

If  the  domainname  is  valid,  ATTRI BUTECLASS  acname  will 
be  updated  to  indicate  the  new  domainno. 

•  DROP  KEYWORD  keyword . . . 

Keyword  references  are  deleted. 

•  ADD  KEYWORD  keyword . . . 

The  keyword(s)  is  created  if  it  does  not  already  exist. 

The  attribute  keyword  reference(s)  is  created. 

Examples : 

ALTER  ATTRIBUTE  CLASS  AC_0RDER_ INFO  DOMAIN  ADDRESS 
ADD  KEYWORD  ZIP 
DROP  KEYWORD  COUNTY: 
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3.S  ALTER  DOMAIN 
Syntax: 

ALTER  DOMAIN  domainname 
[  ADD  [  DATA  ]  TYPE 

data_type_name  /  INTEGER  integer 1 [: Integer 2]  \  ] 


I  CHARACTER  I 

<  SIGHED  > 

I  FLOAT  I 

I  UNSIGNED  I 

\  PACKED  / 

[DROP  [  DATA  ]  TYPE  data_type_naae  . . . ] 

[  ALTER  [  DATA  ]  TYPE 

datatypename  /  INTEGER  integer 1 [: integers]  \  ] 

I  CHARACTER  I 

<  SIGNED 

I  FLOAT  l 

I  UNSIGNED  l 

\  PACKED  / 

[  TO  STANDARD  )]; 


Consents : 

•  The  following  elenents  must  exist  in  the  Connon  Data 
Model : 


domain 
data  type 

•  Integerl  [integer 2] . . .  states  a  range  of  permissable 

values  where  Integerl  is  the  ending  value  and  integer2  is 
the  beginning  value  (integer2  cannot  be  greater  than 
Integerl).  Integer  1  can  be  used  to  specify  a  single 
value  for  a  data  type. 


•  The  NDDL  data  types  correspond  to  the  following 
COBOL/FORTRAN  data  types: 

NDDL  Data  Type  COBOL/FORTRAN  Data  Type 


INTEGER 

CHARACTER 

SIGNED 

FLOAT 

UNSIGNED 

PACKED 


FORTRAN  binary  integer 
X(n) 

S99V99 

FORTRAN  floating  point 

99V99 

COMP -3 
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•  ADD  [  DATA  ]  TYPE 

datatypename  /  INTEGER  integer 1[ : integer 2]  \ 


I  CHARACTER  I 
<  SIGNED 

I  FLOAT  I 
I  UNSIGNED  I 
\  PACKED  / 


The  data  type  will  be  inserted  as  user  defined. 

DROP  {[DATA]  TYPE  datatypenase) . . . 

If  it  is  determined  that  the  data  type  is  associated  with 
a  data  field,  data  item  or  attribute  class  the  data  type 
will  not  be  dropped.  All  attribute  classes  that  use  the 
data  type  are  reported  to  the  user. 

A  standard  data  type  cannot  be  dropped. 

•  ALTER  [  DATA  ]  TYPE 

datatypename  /  INTEGER 

I  CHARACTER 
<  SIGNED 
I  FLOAT 
I  UNSIGNED 
\  PACKED 

[  TO  STANDARD  ] 

The  data  type  is  altered  to  "standard"  (it  will  become  the 
current  standard),  and  the  previous  standard  will  become  a 
user  defined  data  type  for  the  same  domain. 

The  data  type  may  also  be  altered  to  another  legal  type 
with  a  new  size  and  decimal  specifications. 

Examples : 

ALTER  DOMAIN  ADDRESS 

ADD  DATA  TYPE  ALPHA_NUMERC  integer  5:2 
DROP  DATA  TYPE  NUMERIC 

ALTER  TYPE  ALPHA  character  30  to  standard; 


integer 1 [ : integer2]  \ 

I 

i 

i 

/ 
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3.4  ALTER  ENTITY 
Syntax: 

i 

ALTER  ENTITY  [CLASS]  ec_nane 

[ADD  [KEY  [CLASS]  kc_nane [ -  acname  ...]]... 

[ [OWNED]  ATTRIBUTE  [CLASS]  acnane  ...] 

[KEYWORD  keyword  . . . ] ] 

[DROP  [KEY  [CLASS]  kc  naie  ]  ... 

[ [OWNED]  ATTRIBUTE  ICLASS]  ac_nane  ...] 

[KEYWORD  keyword  ...]]; 

Consents : 

e  The  following  elenents  nust  exist  in  the  Coaaon  Data 
Model : 

entity 

attribute  to  be  dropped  or  added 
key  class  to  be  dropped 

•  ADD  KEY  [CLASS]  kc_nane  [»ac_nane  — ]  ... 

An  occurrence  of  attribute  for  acnane  nust  exist. 

A  new  occurrence  of  attribute  use  class  is  created  for 
acnane  if  one  does  not  already  exist.  If  the  attribute 
use  class  does  already  exist,  ac_nane  nay  not  be  owned  by 
any  other  entity. 

A  new  occurrence  of  key  class  is  created  for  the  entity 
using  kc_nane. 

A  new  occurrence  of  key  class  nenber  is  created  for  the 
entity  for  each  ac_nane.  If  ac_nane  is  onitted,  a  key 
class  nenber  occurrence  is  created  using  kc_nane  as  the 
naee  of  the  attribute. 

•  ADD  [OWNED]  ATTRIBUTE  [CLASS]  acnane  ... 

New  attributes  for  the  entity  being  created  are  added. 

Each  attribute  is  created  as  an  owned  attribute  class  for 
the  entity. 

A  new  occurrence  of  attribute  use  class  is  created. 
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•  ADD  KEYWORD  keyword  . . . 

The  keyword  references  are  created. 

The  keyword  will  be  created  if  it  does  not  already  exist. 

•  DROP  KEY  [CLASS]  kc_naae  — 

The  key  class  for  the  entity  i6  deleted. 

All  key  class  aeabers  for  the  key  class  are  deleted. 

If  the  key  class  being  dropped  is  fro*  a  coaplete 
relation,  the  coaplete  relation  is  deleted. 

All  attribute  use  classes  which  were  foraed  froa  a 
aigration  of  that  key  class  aeaber  and  any  aigration  of 
those  attribute  use  classes  are  deleted. 

The  inherited  attribute  use  class  occurrence  of  a  aigrated 
attribute  use  class  is  deleted. 

•  DROP  [OWNED]  ATTRIBUTE  [CLASS]  ac_naae  . . . 

The  owned  attribute  occurrence  and  the  attribute  use  class 
for  acnaae  is  deleted. 

•  DROP  KEYWORD  keyword  . . . 

The  keyword  reference  is  deleted. 

Exaaples : 

ALTER  ENTITY  CLASS  ECCUSTOMER 

ADD  KEY  CLASS  KCCUSTINFO  -  ACCUSTNAHE 
KEYWORD  CUSTOMER; 
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3.5  ALTER  MAP 
Syntax : 

ALTER  MAP  ec-name . tag -name 

[  ADD  {  TO  FIELD  database-name .  recoz'd -name .  dataf  ie  ld-name 
[  TYPE  datatype-name  ]  }  . . . 

I  {  TO  SET  database-name . set -name  VALUE 

‘string'}...] 

[  DROP  {  TO  FIELD  database-name. record -name. dataf i eld- 
name)  . . 

i  {  TO  SET  database-name . set-name) . . . ] 

[  ALTER  {  TO  FIELD  database-name . record-name .dataf 1 eld- 
name  [(p))  [TYPE  datatype-name]) .. . 

I  {  TO  SET  database-name . set -name  VALUE 
‘string' } . . . ] ; 


— or — 


ALTER  MAP  ec-name  rc-name  ec-name 

[  ADD  {  TO  SET  database-name . set -name  [ . member -record- 
name])  . .  ] 


[  DROP  {  TO  SET  database-name . set-name  [ . member -record - 
name]) . . . ] ; 


Comments : 

e  The  following  elements  must  exist  in  the  Common  Data 
Model : 

map  to  be  altered 

dataf i eld  to  be  mapped  to 

set  to  be  mapped  to 

e  Tag-name  is  a  unique  name  for  an  attribute  use  class 

within  an  entity  class.  The  following  rules  apply  when 
altering  Attribute  Use  Class  (AUC)  to  dataf ield  mappings: 

a.  ALTER  ADD  rules  are  the  following: 

The  AUC  must  not  have  previously  been  mapped  to 
a  set . 

The  AUC  must  not  have  been  previously  mapped  to 
a  data  field. 
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If  the  data  type  name  is  not  entered,  the 
standard  data  type  for  the  AUC's  doaain  is  used. 
Only  one  pria&ry  sapping  aay  exist  for  an  ADC. 
Multiple  secondary  mappings  aay  exist  if  there 
is  a  pre-existing  priaary  mapping. 

If  the  priaary  or  secondary  napping  is  not 
specified,  the  default  is  priaary. 

b.  ALTER  DROP  will  not  drop  a  priaary  datafield  map  if 
secondary  saps  exist  for  a  particular  AUC. 

c.  ALTER  ALTER  will  modify  the  primary-secondary 
indicator  and/or  the  datatype  name.  To  change  a 
secondary  aap  to  priaary  and  to  change  the  previous 
priaary  aap  to  secondary,  include  the  (P)  option.  To 
change  the  datatype  name,  include  the  datatype  name 
in  the  ALTER  ALTER  coaaand. 

•  The  following  rules  apply  when  altering  AUC  to  set 
mappings : 

a.  ALTER  ADD  rules  are  the  following: 

A  data  field  napping  must  not  exist  for  the  AUC. 
The  set  to  be  aapped  to  aust  have  a  single 
record  type  for  its  members. 

The  aember  record  name  is  not  used  in  AUC  to  set 
mappings . 

The  set  to  be  napped  to  aust  not  previously  have 
been  aapped  from  a  relation  class  or  another 
AUC. 

All  AUC  to  set  maps  aust  aap  to  the  same 
database  for  a  particular  AUC. 

All  AUC  to  set  maps  aust  contain  a  value  that 
aust  be  unique  for  a  particular  AUC. 

Each  set  mapped  to  from  the  AUC  aust  have  the 
same  record  type  as  its  owner. 

b.  No  special  rules  apply  to  ALTER  DROP. 

c.  ALTER  ALTER  will  modify  the  AUC  value  for  a 
particular  AUC  to  set  map.  The  new  AUC  value  must  be 
entered  and  must  be  unique  for  that  particular  AUC. 

•  The  following  rules  apply  when  altering  Relation  Class 
(RC)  to  set  member  mapping: 
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a.  ALTER  ADD  rules  are  the  following: 

The  member  record  name  may  be  omitted  if  the  set 
to  be  mapped  to  i&  a  single  member  record  type 
set;  otherwise  the  member  record  name  is 
required. 

There  must  be  no  previous  mappings  to  the  set. 
The  value  is  not  used  in  Relation  Class  to  set 
mappings . 

b.  ALTER  DROP  requires  a  member  record  name  entry  if,  by 
omitting  it,  the  “to  set"  specification  would  be 
ambiguous . 

c.  ALTER  ALTER  is  invalid  for  RC  to  set  maps. 

Examples : 

ALTER  MAP  DEPARTMENT . EMPLOYEE 

ADD  TO  FIELD  EMPDB . EREC1 . RATE 

TO  FIELD  EMPDB. EREC2.SSN0  TYPE  SS 
DROP  TO  FIELD  EMPDB . AREC . DEPTMO 
ALTER  TO  FIELD  EMPDB . EREC1 . EMPMO  (P) 

TO  FIELD  EMPDB. EREC2. TITLE  TYPE  JOBTITLE; 

ALTER  MAP  PART. COMPOSITION 

ALTER  TO  SET  MATERIAL .COMPOSITE  VALUE  COMPOSITE'; 

ALTER  MAP  INVENTORY  HAS  SHELFLIFE 

DROP  TO  SET  SLDB. BATTERY. NICAD; 
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S.6  ALTER  MODEL 
Syntax: 

ALTER  MODEL  modelname ; 

Comments : 

•  Required  existenoe  in  the  Common  Data  Model: 

model  class 

•  The  model  is  updated  and  marked  as  unchecked. 

•  The  model  becomes  the  "current”  model  for  all  other 
modeling  commands  and  remains  current  until  another  CREATE 
MODEL  or  ALTER  MODEL  command  is  entered. 

Examples : 

ALTER  MODEL  ABC  COMPANY; 
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3.7  ALTER  RELATION 
Syntax: 

ALTER  RELATION  [CLASS]  [ {INTEGER 1 1 MANY) ]  indecnamel 
rename  [ { INTEGER2 :  INTEGER3 I MANY }  dep_ec_name2 
[ADD  [MIGRATES  {kc  name  [SET  (tagnamel  - 
tag_name2) ...]}]  TKEYWORD  keyword . . . ] ] 

[DROP  [MIGRATES  kc_name  ] . . .  [KEYWORD  keyword. . . ] ] ; 

Comments : 

•  The  above  command  the  following  elements  must  exist  in 
Common  Data  Model : 

model 

relation  class 

independent  entity  ( ind_ec_nanel ) 
dependent  entity  (dep_ec_name2) 


•  ALTER  RELATION  [CLASS]  [ INTEGER1 I MANY ]  ind_ec_namel 

rename  [ INTEGER2 :  { INTEGER3 I MANY } ]  dep_ec_name2 

The  relation  is  altered  if  any  cardinality  is  altered. 

Integerl  or  many  indicates  the  cardinality  for  the 
independent  entity  class.  Integer2  and  integer3  indicate 
the  cardinality  for  the  dependent  entity  class. 

Cardinality  values  default  to  the  current  cardinality  for 
the  Relation. 

A  warning  message  may  be  generated  to  indicate  either  left 
or  right  dependent  cardinality  too  large.  This  will  not 
halt  processing  but  defaults  the  value  to  the  current 
cardinality  of  the  relation  class.  The  right  dependent 
cardinality  (integer2)  cannot  be  less  than  the  left 
dependent  cardinality  (integer3). 

Individual  cardinalities  may  be  changed  without  changing 
all  the  cardinalities. 

The  right  dependent  (integer3)  cardinality  cannot  be  zero. 

•  [ADD  [MIGRATES  {kc_name  [SET  (tagnamel  -  tag_name2 } . . . ] } 

[KEYWORD  keyword ...]]] 
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The  following  elements  must  exist  in  the  Common  Data 
Model : 

key  class  for  independent  entity 
key  class  members  for  the  independent  entity 
attribute  use  class  for  each  key  class  member 
associated  with  the  independent  entity 

The  key  class  cannot  have  been  previously  migrated  to  the 
dependent  entity. 

An  attribute  use  and  an  inherited  attribute  use  class  for 
the  dependent  entity  is  created  for  each  key  class  member 
of  the  independent  entity  migrated  to  the  dependent 
entity. 

If  the  set  phrase  is  specified,  tag_namel  (the  independent 
entity's  tag  name)  is  migrated  with  the  new  name  of 
tag_namel . 

A  complete  relation  class  occurrence  is  created. 

The  keyword  is  created  in  the  Common  Data  Model  if  it  does 
not  already  exist. 

A  relation  class  keyword  reference  is  created. 

•  [DROP  [MIGRATES  kc_name] .. .  [KEYWORD  keyword. ..]] ; 

The  key  class  migration  will  be  dropped  from  each  relation 
and  entity  in  the  model. 

The  relation  class  keyword  reference  is  deleted. 

Examples : 

ALTER  RELATION  CLASS  IND_EC_STORE  RC_INVOICING 
DEP_EC_CUSTOMER 

ADD  MIGRATES  KC_0RDER  SET  AC_INVOICE  -  AC_F0RM 
DROP  KEYWORD  KCORDER ; 

ALTER  RELATION  CLASS  IND_EC_DEPARTMENT  HAS 
DEP  EC  EMPLOYEE; 
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3.8  CHECK  MODEL 
Syntax: 

CHECK  MODEL  nodel_nane; 

Consents : 

e  node Ins no  nust  exist. 

e  If  the  nodel  neeis  all  rules,  the  nodel  will  be  narked  as 
checked . 


The  following  rules  are  checked  for  the  nodel: 

a.  no  non-specific  relations  are  allowed  (independent 
cardinality  greater  than  one) 

b.  no  inconplete  relations  (key  has  not  been  nigrated) 

c.  each  entity  has  at  least  one  attribute  use  class 

d.  each  owned  attribute  has  a  dona in  and  that  donain  has 
a  standard  data  type 

e.  a  key  is  defined  for  each  entity 

f.  nultiple  key  classes  of  an  entity  are  not  subsets  of 
one  another 

g.  no  one  to  one  relations 

h.  no  dependency  loops,  e.g.,  A->B->C->A. 

i.  at  least  one  entity  exists  in  the  nodel 

The  following  rules  cannot  be  checked  for  the  nodel: 

a.  one  to  none  or  one  relationships  inplying  identical 
keys 

b.  key  uniqueness  throughout  the  nodel  is  not  checked, 
i.e.,  no  two  entities  nay  have  the  sane  key  unless 
they  are  related  to  each  other  with  a  one  to  none  or 
one  relation 


Exaaples : 


CHECK  MODEL  A; 


CHECK  MODEL  INTEGRATED  MODEL; 


3-14 


DM  620141100 
1  November  1985 


3.9  COMBINE  ENTITY 

Syntax: 

COMBINE  ENTITY  ecnaiel  [PROM  MODEL  model_name]  INTO 
ec_na«e_2  ON  FILE  'file  name ' 

[EXCEPT  [DESCRIPTION!  [ALIAS]  [KEYWORD]]; 

Comments : 

•  If  modelnaxe  is  not  entered,  an  intra-model  combine  is 
assumed  and  ecnaiel  must  not  be  the  same  as  ec_nane_2. 
The  current  model  will  be  used. 

•  The  NDDL  statements  necessary  to  physically  combine  the 
two  entities  are  generated  on  the  file  named .  if  the 
named  file  does  not  exist,  it  is  created  and  opened.  If 
the  named  file  does  exist,  the  generated  NDDL  is  appended 
to  the  file. 

•  On  an  intra-model  combine,  any  relations  between  ecnamel 
and  ec_name_2  will  be  dropped  and  ecnaiel  will  be 
dropped . 

•  All  owned  attributes  of  ec__name_l  and  their  aliases, 
keywords,  and  descriptions~are  generated  for  ec_name_2,  or 
the  corresponding  keyword  appears  in  the  EXCEPT  clause. 

•  All  entity  name  aliases,  keywords,  and  descriptions  of 
ec_name_l  are  generated  as  aliases,  keywords,  and 
descriptions  of  ec_name_2  unless  they  already  exist  for 
ec_name_2,  or  the  corresponding  keyword  appears  in  the 
EXCEPT  clause. 

•  All  relations  in  which  ec_name_l  is  the  dependent  entity 
are  generated  for  ec_name_2,  provided  the  independent 
entities  in  Mie  relations  already  exist  in  the  current 
model  and  the  relation  names  are  not  already  associated 
with  ec_name_2.  The  key  classes  of  the  independent 
entities  are  migrated  to  ec_name_2  and  all  key  classes  of 
ec_name_l  are  generated  for  ec_name_2. 

•  All  relations  in  which  ec_name_l  is  the  independent  entity 
are  generated  for  ec_name_2,  provided  the  dependent 
entities  already  exist  in  the  current  model  and  the 
relation  names  are  not  already  associated  with  ec_name_2. 
The  key  class  of  ec_name_l  is  migrated  to  the  dependent 
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entities . 

e  If  the  EXCEPT  clause  is  entered,  at  least  one  option  must 
be  specified.  If  used,  the  options  must  appear  in  the 
order  indicated.  If  DESCRIPTION  is  entered,  no 
descriptions  for  entities,  attributes,  and  relations  will 
be  generated  or  copied.  If  ALIAS  is  entered,  no  aliases 
for  entities  and  attributes  will  be  generated  or  copied. 

If  KEYWORD  is  specified,  no  keywords  for  entities, 
attributes,  and  relations  will  be  generated  or  copied. 

•  Generated  Couands : 

The  generated  NDDL  commands  should  be  examined  for 
potential  run-time  errors. 

a.  If  the  entity  being  combined  has  inherited 
attributes,  then  the  generated  NDDL  must  be  changed 
either  to  add  the  inherited  attributes  to  the  new 
entity  as  owned  attributes,  or  all  references  to  the 
Inherited  attributes  must  be  deleted  from  KET  CLASS 
and  MIGRATES  clauses. 

b.  A  create/alter  entity  command  may  attempt  to  add  am 
owned  attribute  when  the  attribute  is  already  owned 
by  another  entity  in  the  target  model.  The  modeler 
must  decide  which  entity  should  own  the  attribute  and 
change  the  NDDL  accordingly. 

NOTE: 

When  an  attribute  is  added  to  an  entity  and  the 
attribute  already  exists  in  the  target  model,  a 
comment  is  generated  in  the  NDDL  oommand  following 
the  attribute.  The  comment  is: 

/*  ATTRIBUTE  MAY  BE  OWNED  IN  TARGET  MODEL  */ 

Examples : 

COMBINE  ENTITY  ENT8  INTO  ENT_B  ON  FILE  ENTB.DAT'  EXCEPT 
DESCRIPTION; 

COMBINE  ENTITY  ENT_B  FROM  MODEL  SPARKY  INTO  ENT_B  ON  FILE 
' CMBENT . ZZZ ' ; 
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3. 10  COMPARE  MODEL 
Syntax: 

COMPARE  MODEL  nodelnanel  WITH  iodel_naae2; 

Consents : 

•  node 1 _nane_ 1  and  node 1 _nane_2  nust  both  exist. 

•  Sini lari ties,  or  points  of  correspondence  of  the  two 
nodels  will  be  reported: 

a.  entity  names  correspond,  (natch  identically)  either 
through  pr inary  naae  or  alias 

b.  attribute  nanes  correspond,  either  through  pr inary 
naae  or  alias 

c.  entity  keywords  correspond 

d.  attribute  keywords  correspond 

e.  relation  keywords  correspond 

Exaaples : 

COMPARE  MODEL  A  WITH  MODEL  B; 
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3.11  COPY  ATTRIBUTE 
Syntax: 

COPY  ATTRIBUTE  attr  nanel  [FROM  MODEL  nodelnane] 

[TO  attr_name_2]  TOM  FILE  'file  nane'] 

[EXCEPT  [DESCRIPTION]  [ALIAS'!  [KEYWORD]  ] ; 

Co— ants: 

•  If  fron  model  is  used,  attrnaiel  must  exist  in  that 
model . 

•  If  attr_nase_2  is  not  entered,  the  copy  attribute  must  be 
an  inter-model  copy  and  attr_name_2  will  be  the  same  as 
attrnamel . 

•  The  attribute  will  always  be  oopied  to  the  current  model 
unless  the  FILE  clause  is  specified. 

e  If  from  model  has  been  omitted,  oopy  attribute  will  be  an 
intra-model  copy  and  attrjname _2  must  be  entered. 

•  All  of  the  attrnaiel ' s  descriptions,  aliases,  and 
keywords  will  be  copied,  unless  the  corresponding  appears 
in  the  EXCEPT  clause. 

•  If  the  FILE  clause  is  specified,  NDDL  commands  will  be 
generated/appended  on  the  file  specified. 

•  Refer  to  COMBINE  ENTITY  for  a  complete  description  of  the 
EXCEPT  clause. 

Examples : 

COPY  ATTRIBUTE  A1  FROM  Ml  TO  A4; 

COPY  ATTRIBUTE  A3  FROM  M2  ON  FILE  ' A3 . DAT ' ; 

COPY  ATTRIBUTE  A5  TO  A6 

EXCEPT  DESCRIPTION  ALIAS; 
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5.12  COPY  DESCRIPTION 
Syntax: 

COPY  desc_type  OF  object  type  objectidl 
[FROM  MODEL  node 1 _na*eT  TO  object_id_2 ; 

Consents : 

•  Objectid  can  be  an  Attribute  Use  Class,  Entity  Use  Class, 
or  a  Relation  Class. 

•  This  is  a  partial  description  copy.  Only  the  description 
lines  of  the  identified  description  type  of  the  given 
object  will  be  copied,  rather  than  all  description  types. 

•  object_type  and  desctype  are  defined  in  the  DESCRIBE 
connand . 

•  If  nodel_naae  is  onitted.  the  current  nodel  will  be  used 
when  looking  for  object_id_l  and  object_id_2  must  not  be 
the  sane  as  object_id_l . 

•  A  description  cannot  be  copied  from  an  occurrence  of  one 
object  type  to  a  different  object  type. 

•  Object  id's  can  consist  of  multiple  words  for  relations, 
(ref  DESCRIBE  command). 

•  object_id_2  must  exist  in  the  current  model. 

Examples : 

COPY  DEFINITION  OF  ENTITY  El  TO  E2 ; 

COPY  USAGE  OF  ENTITY  E2  FROM  MODEL  Ml  TO  E2; 

COPY  DEFINITION  OF  RELATION  El  USES  E3  TO  E6  OWNS  E7; 
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3.13  COPY  ENTITY 
Syntax: 

COPY  ENTITY  [CLASS]  ec_name_l  [PROM  MODEL  modelj&ame] 

[TO  ecname_2]  [WITH  {  STRUCTURE  }  OH  PILE  f ilename' ] 

{  RELATION  } 

[EXCEPT  [DESCRIPTION]  [ALIAS]  [KEYWORD]]; 


Contents  : 

•  The  following  elenents  must  exist  in  the  Coaaon  Data 

Model : 

entity  being  copied 
current  aodel 

•  If  the  FROM  clause  is  omitted,  an  intra-aodel  copy  is 

assuaed  and  the  following  rules  apply: 

a.  ec_naae_2  aust  be  entered  and  aay  not  be  the  saae  as 
ecnaael . 

b.  The  WITH  clause  aust  be  oaitted. 

c.  A  new  entity  is  built  for  the  current  aodel. 

d.  All  keywords,  aliases,  and  descriptions  for  the 
entity  being  copied  are  created  for  the  new  entity 
unless  excepted. 

e.  All  key  classes  and  key  class  aeabers  for  the  entity 
being  copied  are  created  for  the  new  entity. 

f.  Attributes  associated  with  the  entity  are  not  copied. 

•  If  the  FROM  clause  is  entered,  an  inter-model  copy  is 

assumed  and  the  following  rules  apply: 

a.  The  entity  being  copied  must  not  exist  in  the  current 
model . 

b.  If  ec_name_2  is  omitted  the  name  of  the  new  entity 
will  be  the  same  as  ecnaael . 

c.  The  WITH  clause  is  required. 

d.  The  entity  being  copied  and  its  relations  or 
structures  are  not  physically  added  to  the  current 
model.  Instead,  the  NDDL  commands  necessary  to  add 
the  entity  to  the  current  model  are  generated  and 
written  to  the  file  named  on  the  'FILE'  clause.  If 
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the  nwnert.  file  does  not  exist,  a  new  file  is  created 
and  opened.  If  the  n inert  file  does  exist,  the 
generated  ooanands  are  appended  to  the  file. 

e.  A  new  entity  is  generated  for  the  current  nodel. 

f.  The  following  iteas  are  generated  for  the  new  entity 
unless  they  already  exist  in  the  current  nodel  or 
have  been  excepted: 

All  keywords,  aliases,  and  descriptions 
associated  with  the  entity  being  oopled. 

All  the  attributes  owned  by  the  entity  being 
copied.  Note  that  attributes  inherited  by  the 
entity  being  copied  are  not  generated. 

All  key  classes  and  key  class  aeabers  belonging 
to  the  entity  being  oopied. 

If  the  RELATION  option  is  chosen  on  an  inter-aodel  copy. 

the  following  applies: 

a.  All  relations  in  which  the  entity  being  oopied  is  the 
dependent  entity  are  generated  for  the  current  nodel, 
provided  the  independent  entities  in  the  relations 
exist  in  the  current  nodel. 

b.  All  relations  in  which  the  entity  being  oopied  is  the 
independent  entity  are  generated  for  the  current 
nodel,  provided  the  dependent  entities  in  the 
relations  exist  in  the  current  nodel. 

c.  All  key  classes  that  were  nigrated  in  the  relations 
being  copied  are  nigrated  in  the  current  nodel .  The 
sane  nanes  used  in  the  relation  being  copied  are 
generated  for  the  current  nodel . 

If  the  STRUCTURE  option  is  chosen  on  an  inter-nodel  copy, 

the  following  applies: 

a.  The  tree  structure  dependent  on  the  entity  being 
copied  is  generated  for  the  current  nodel.  This 
includes  the  entities,  their  keywords,  aliases, 
descriptions,  owned  attributes,  key  classes  and  key 
class  members;  the  relations,  their  nigrated  keys  and 
set  nanes.  Note  that  everything  associated  with  the 
structure  is  generated  for  the  current  nodel,  whether 
or  not  it  exists  in  the  current  nodel. 

Refer  to  COMBINE  ENTITY  for  complete  description  of  EXCEPT 

clause. 
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e  Generated  Commands : 

The  generated  MDDL  commands  should  be  examined  for 

potential  run-time  errors. 

a.  If  the  entity  being  copied  has  inherited  attributes, 
then  the  generated  MDDL  must  be  changed  either  to  add 
the  inherited  attributes  to  the  new  entity  as  owned 
attributes,  or  all  references  to  the  inherited 
attributes  must  be  deleted  from  KEY  CLASS  and 
MIGRATES  clauses. 

b.  If  a  tree  structure  i6  being  copied,  then  the  create 
commands  for  any  entitles,  attributes,  aliases,  and 
relations  that  already  exist  in  the  current  model 
must  be  deleted. 

c.  A  create/alter  entity  command  may  attempt  to  add  an 
owned  attribute  to  an  entity  when  the  attribute  is 
already  owned  by  another  entity  in  the  target  model. 
The  modeler  must  decide  vhioh  entity  should  own  the 
attribute  and  change  the  MDDL  accordingly. 

MOTE: 

When  an  attribute  is  added  to  an  entity  and  the 
attribute  already  exists  in  the  target  model,  a 
comment  is  generated  in  the  MDDL  command  following 
the  attribute.  The  comment  is: 

/*  ATTRIBUTE  MAY  BE  OWNED  IM  TARGET  MODEL  */ 

Examples : 

COPY  ENTITY  INVOICE  TO  MEW INVOICE 

EXCEPT  DESCRIPTION  ALIAS  KEYWORD; 

COPY  EMTITY  INVOICE  FROM  MODEL  ABCCOMPANY  WITH  STRUCTURE 
OH  FILE  ' EXAMINE. NDL' 

EXCEPT  ALIAS; 
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3.14  COPY  MODEL 

Syntax: 

COPY  MODEL  [FROM  MODEL  modelname]  TO  newmodel  OH  FILE 
'filename'  [EXCEPT  [DESCRIPTIOH]  [ALIAS]  [KEYWORD]]; 

Comments : 

•  If  the  FROM  clause  is  entered,  model_name  must  exist.  If 
it  is  omitted,  the  current  model  will  be  copied. 

•  newmodel  must  not  exist. 

•  The  model  being  copied  may  not  contain  any  dependency 
loops. 

•  MDDL  commands  are  generated  in  the  proper  sequence  to 
create  a  new  model  containing  all  the  entities,  owned 
attributes,  inherited  attributes,  key  classes,  key  class 
members,  relations,  aliases,  keywords,  and  descriptions  in 
the  model  being  copied. 

•  Aliases,  keywords,  and/or  descriptions  will  be  excluded 
from  the  generated  NDDL  if  the  corresponding  option 
appears  in  the  EXCEPT  clause.  Refer  to  COMBINE  ENTITY  for 
a  complete  description  of  the  EXCEPT  clause. 

•  If  the  named  file  does  not  exist,  a  new  file  is  created 
and  opened.  If  the  file  does  exist,  the  generated 
commands  are  appended  to  the  file. 

Examples : 

COPY  MODEL  FROM  MODEL  Ml  TO  M2  ON  FILE  ' M2 . DAT ' ; 
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3.15  CREATE  ALIAS 
Syntax: 

CREATE  ALIAS  {  EMTITY  ec  n&ael  [IS)  ec  naae2 

l  ATTRIBUTE  ac_naael  [IS]  ao_naae2  )  ; 

Consents : 

•  The  following  elements  nust  exist  in  the  Common  Data 
Model : 

ent i ty 
attribute 

•  ec_naae2  and  ac_naae2  are  the  naaes  to  be  created  as 
aliases  for  entity  and  attribute  respectively. 

Examples : 

CREATE  ALIAS  EHTITY  CUSTOMER  IS  CUST; 

CREATE  ALIAS  ATTRIBUTE  ORDER  HUMBER  IS  ORDHO; 
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3.16  CREATE  ATTRIBUTE 
Syntax: 

CREATE  ATTRIBUTE  [CLASS]  ac_nane  [DOMAIN  donainnane] 
[KEYWORD  keyword  . . . ] ; 

Comments : 

•  CREATE  ATTRIBUTE  [CLASS]  &c_naae 

Required  existence  in  the  Conaon  Data  Model: 

the  current  nodel 

A  new  attribute  is  created  for  the  current  nodel. 

•  [DOMAIN  domainname] 

The  domainjoaae  must  naae  an  existing  donain. 

If  donainnane  is  not  specified,  the  donain_no  for  the 
attribute_class  will  be  undefined. 

•  KEYWORD  keyword  . . . 

The  keyword  will  be  created  in  the  Conmon  Data  Model  if  it 
does  not  already  exist. 

Keyword  references  are  created  for  the  attribute. 

Examples : 

CREATE  ATTRIBUTE  ORDER_DATE  DOMAIN  DATE 
KEYWORD  KEY  DATE; 
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3.17  CREATE  DOMAIN 
Syntax: 

CREATE  DOMAIN  domain_name  STANDARD  _ 

[DATA]  TYPE  data_type_nane  /  CHARACTER  \ 

I  PACKED  l 
<  SIGNED 
I  UNSIGNED  I 
\  INTEGER  / 

integerl [:  integers] 

Consents : 

•  A  new  domain  is  created  within  the  system. 

•  All  specified  data  types  are  added  for  the  domain. 

•  A  standard  data  type  must  be  specified.  Remaining  data 
types  for  that  domain  will  be  U6er  defined  data  types. 

•  Integer 1  [integer2] . . .  states  a  range  of  permissable 
values  where  integer 1  is  the  ending  value  and  integer2  is 
the  beginning  value  (integer2  cannot  be  greater  than 
integerl .  Integerl  can  be  used  to  specify  a  single  value 
for  a  data  type. 

•  The  NDDL  data  types  correspond  to  the  following 
COBOL/FORTRAN  data  types: 


NDDL  Data  Type 


COBOL/ FORTRAN  Data  Type 


CHARACTER 

PACKED 

SIGNED 

UNSIGNED 

INTEGER 

FLOAT 


X(n) 

COMP- 3 
S99V99 
99V99 

FORTRAN  binary  integer 
FORTRAN  floating  point 


Examples : 


CREATE  DOMAIN  ZIP_C0DE  standard 
TYPE  ABC  character  30 
TYPE  XY2  integer  6:2; 
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3.18  CREATE  ENTITY 
Syntax: 

CREATE  ENTITY  [CLASS]  ec_naae 

[KEY  [CLASS]  kc_naae[-  ac_naae  ...]]... 

[[OWNED]  ATTRIBUTE  [CLASS]  ac_naae  ...] 
[KEYWORD  keyword  . . . ] ; 


Consents : 

•  CREATE  ENTITY  [CLASS]  ecnane 

A  new  entity  is  created  for  the  current  nodel . 

•  KEY  [CLASS]  kc  naie  [  -  ac_nane  ...] 

Required  existence  in  the  Coanon  Data  Model: 

attribute 

A  new  occurrence  of  attribute  use  class  and  owned 
attribute  is  created  for  ac_naae  if  one  does  not  already 
exist.  If  the  attribute  use  class  does  not  already  exist, 
ac_nane  aay  not  be  owned  by  any  other  entity. 

A  new  occurrence  of  key  class  is  created  for  the  entity 
using  kcname. 

A  new  occurrence  of  key  class  nember  is  created  for  the 
entity  for  each  acname.  If  ac_name  is  onitted,  a  key 
class  nember  occurrence  is  created  using  keyname. 

•  [OWNED]  ATTRIBUTE  [CLASS]  acname  ... 

Required  existence  in  the  Common  Data  Model: 

attribute 

New  attributes  for  the  entity  being  created  are  added. 

Each  attribute  class  is  created  as  an  owned  attribute 
class  for  the  entity. 

A  new  occurrence  of  an  attribute  use  class  is  created. 

•  KEYWORD  keyword . . . 
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Keyword  references  are  created  for  the  entity. 

The  keyword  will  be  created  if  it  does  not  already  exist. 
Examples: 

CREATE  ENTITY  SALESPERSON 

KEY  ORDER  -  ORDERNUMBER 

OWNED  ATTRIBUTE  SALES 
KEYWORD  SALES  ID; 
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3.19  CREATE  MAP 
Syntax: 

CREATE  MAP  {  ecname . tagname 

I  i nd_ec_name 1  rename  dep_ec_name2) 

{{TO  FIELD  database_name.record_name.datafield_name 
t { ( p)  i(s)}3  [TYPE  datatypename] }  ... 
i {TO  SET  database  name . set_name  t . aeiberrecordnaae ] 
[  VALUE  string’])...}; 


Comments : 


The  following  elements  must  exist  in  the  Common  Data 

Model  : 

Integrated  Model  (model  number  -  1) 

Attribute  Use  Class  (AUC)  to  be  mapped 

Relation  Class  to  be  mapped 

Data  field  mapped  to 

Database  mapped  to 

Record  mapped  to 

Set  mapped  to 

The  following  rules  apply  to  AUC  ( ecname . tagname )  to 

datafield  mappings: 

a.  The  AUC  must  not  have  previously  been  mapped  to  a 
set . 

b.  The  AUC  must  not  have  been  previously  mapped  to  a 
datafield . 

c.  If  the  datatype  name  is  not  entered,  the  standard 
datatype  for  the  AUC's  domain  is  used. 

d.  Only  one  primary  mapping  may  exist  for  an  AUC. 

e.  Multiple  secondary  mappings  may  exist  if  there  is  a 
pre-existing  primary  mapping. 

f.  If  the  primary  or  secondary  mapping  is  not  specified, 
the  default  is  primary. 

The  following  rules  apply  to  AUC  to  set  mappings: 

a.  A  datafield  mapping  must  not  exist  for  the  AUC. 

b.  The  set  to  be  mapped  to  must  have  a  single  record 
type  for  its  members. 

c.  The  member  record  name  is  not  used  in  AUC  to  set 
mappings . 
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d.  The  set  to  be  sapped  to  mist  not  previously  have  been 
sapped  fros  a  relation  class  or  another  ADC. 

e.  All  ADC  to  set  saps  sust  sap  to  the  sase  database  for 
a  particular  ADC. 

f.  All  ADC  to  set  saps  sust  contain  a  value  which  sust 
be  unique  for  a  particular  ADC. 

g.  All  sets  sapped  to  fros  the  ADC  sust  have  the  sase 
record  type  as  its  owner. 

The  following  rules  apply  to  Relation  Class  to  set 
sappings : 

a.  The  nenber  record  nase  say  be  ositted  if  the  set  to 
be  sapped  to  is  a  single  sesber  record  type  set; 
otherwise  the  sesber  record  nase  is  required. 

b.  There  sust  be  no  previous  sappings  to  the  set. 

c.  The  value  is  not  used  in  Relation  Class  to  set 
sappings . 

A  Relation  Class  to  datafield  sap  is  illegal. 

Exasples: 

CREATE  MAP  PART. SIZE  TO  FIELD  PARTDB.PREC.PSIZE 

TO  FIELD  P ARTDB.PREC2.PS I ZE2  (S) 
TYPE  METRIC  ; 

CREATE  MAP  ORDER. STATDS  TO  SET  CUSTDB. INPROCESS  VALUE  1' 

TO  SET  CDSTDB . BAKORDER  VALUE  2' 
TO  SET  CUSTDB. SHIPPED  VALUE  '3'; 

CREATE  MAP  EMPLOYEE  POSSESSES  SKILLS 
TO  SET  SKILLDB . SETA . RECA 
TO  SET  SKILLDB. SETB  ; 
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3.20  CREATE  MODEL 
Syntax: 

CREATE  MODEL  node 1 _nane ; 

Consents : 

#  A  new  aodel  is  created  as  unchecked  in  the  sy6ten. 

e  The  nodel  is  the  “current"  model  for  following  modeling 

commands  until  another  CREATE  MODEL  or  ALTER  MODEL  command 
is  entered. 

Examples : 

CREATE  MODEL  DEF  COMPANY; 


r 
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3.21  CREATE  RELATION 
Syntax: 

CREATE  RELATION  [CLASS]  [ { INTEGER1 I MANY } ]  indecnamel 
rename  [ { INTEGER2 :  INTEGERS  I KANT}  dep_ecna*e2 

[MIGRATES  { kc_na*e  [SET  [tag_namel  -  tag_name2 }...]} ] 
[KETVORD  keyword  . . . ] ; 

Consents : 

•  CREATE  RELATION  [CLASS]  [ {INTEGER1 I MANY) ]  ind_ec_nanel 
re  name  [ { INTEGER2 :  INTEGERS  I MART}  dep_ec_nane2 

The  following  elements  must  exist  in  the  Common  Data 
Model : 

model 

independent  entity  ( indecnamel ) 
dependent  entity  (dep_ec_name2) 

A  new  relation  is  inserted. 

Cardinalities  for  the  entities  of  the  relation  are 
inserted.  Integer 1  or  many  indicates  the  cardinality  for 
the  independent  entity  class.  Integer2  and  integer3 
indicate  the  cardinality  for  the  dependent  entity  class. 

If  integer 1  or  many  is  omitted,  the  independent 
cardinality  defaults  to  one.  If  integer2  is  omitted,  the 
left  dependent  cardinality  defaults  to  zero.  If  integer3 
or  many  is  omitted,  the  right  dependent  cardinality 
defaults  to  many.  For  example,  if  DEPARTMENT  (ex_namel) 
can  have  0  or  many  Employees  (ec_name2): 

CREATE  RELATION  1  DEPARTMENT  HAS  0:MANY  EMPLOYEES 

-  or  - 

CREATE  RELATION  DEPARTMENT  HAS  EMPLOYEE 
Integer3  may  not  be  less  than  integer2. 

Integer3  may  not  be  zero. 


•  MIGRATES  kename  [SET  {tagnamel  -  tag_name2}  ...] 
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The  following  elements  must  exist  in  the  Common  Data 
Model : 

key  class  for  independent  entity 
key  class  members  for  independent  entity 
attribute  use  class  for  each  key  class  member 
associated  with  the  Independent  entity 

The  key  class  cannot  have  been  previously  migrated. 

The  dependent  entity  cannot  end  up  with  attribute  use 
classes  with  the  same  tag  name  (a  unique  name  for  an 
attribute  use  class  within  an  entity  class). 

An  attribute  use  class  and  an  inherited  attribute  use 
class  for  the  dependent  entity  are  created  for  each  key 
class  member  of  the  independent  entity  migrated  to  the 
dependent  ENTITY. 

If  the  set  phrase  is  specified,  tag_name2  (the  independent 
entity's  tag  name)  is  migrated  with  the  new  name  of 
tag_namel . 

A  complete  relation  class  occurrence  is  created. 

•  KEYWORD  keyword  . . . 

The  keyword  is  created  if  it  does  not  exist. 

A  relation  keyword  reference  i6  created. 

Examples : 

CREATE  RELATION  INVOICE  SUPPLIES  0RDERINF0 
MIGRATES  ORDER  SET  ORDERNUMBER  -  ORDNO 
KEYWORD  ORDER  DATA; 
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S.22  CREATE  VIEW 
Syntax: 

CREATE  VIEW  vlew  nue  [DATA  ITEM  datai temname 
[[DATA]  TYPE  dat a_ t ypename ] ] . . 

AS  S£LECT{ l * 

tagn&ae  . . . i 
[abbrev . ] tagname — ) 

FROM { ecname 

l ecnaae . abbrev . . . } 

[WHERE  indecname  rename  depecname  [and...]] 

Comments : 

•  To  create  a  VIEW  (SURROGATE  ENTITY  CLASS)  using  the  above 
command,  the  following  elements  must  exist  in  the  Common 
Data  Model : 

independent  entity 
dependent  entity 
relation  class 
entity 

data  items  and  attribute  use  classes  from  the  same 
domain  existence  of  standard  data  type 

•  CREATE  VIEW  viewname 

A  new  view  (SURROGATE  ENTITY  CLASS)  is  created  if  it  does 
not  exist. 

The  relationship  between  view  and  relation  is  created. 

•  DATAITEM  dataitemname  [[DATA]  TYPE  data_type_name ] . . . 

Must  be  specified  when  views  are  built  from  more  than  one 
ent i ty . 

The  data  items  must  correspond  in  order  and  number  to  the 
attribute  use  class  tags  specified  in  the  select  clause. 

If  data  type  name  is  not  specified,  the  data  type  will 
become  the  standard  data  type  for  the  corresponding 
attribute  use  class. 

•  AS  SELECT { * l 

tag_name ...  I 
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[abbrev . ] tagnaae 
If  an  *  is  specified: 

a.  The  FROM  clause  may  not  be  oaitted. 

b.  A  data  itea  and  project  data  1 tea  occurrence  are 
created  for  each  attribute  use  class  associated  with 
the  entity  naaed  on  the  FROM  clause. 

If  the  tags  (unique  attribute  use  classes  within  an  entity 
class)  are  selected  froa  a  single  entity,  the  ABBREV  nay 
be  oaitted  provided  a  FROM  clause  is  specified  without  an 
abbreviation. 

If  tags  are  selected  froa  aore  than  one  entity,  both 
abbreviations  and  tag  naaes  aust  be  specified  and  a  FROM 
clause  with  entity  naaes  and  abbreviations  aust  be 
specified. 

Data  itea  and  project  data  itea  occurrences  are  created 
for  each  attribute  use  class  naaed  in  the  select. 

If  abbreviations  are  used,  they  aust  be  used  for  all 
attribute  use  classes. 

FROM  [ecnaae 

I ecnaae. abbrev} . . . 

The  abbreviation  for  the  entity  aust  be  included  if  the 
ABBREV  is  used  in  the  select  clause. 

WHERE  {ind_ec_naae  rc_naae  depecname  [and]}... 

The  WHERE  clause  aust  be  specified  when  tags  are  selected 
froa  more  than  one  entity. 

Each  entity  specified  in  the  FROM  clause  must  appear  as 
either  the  independent  entity  or  dependent  entity  in  a 
WHERE  clause  relation. 

The  relation  class  name  aust  be  valid. 

Abbreviations  are  not  allowed  in  the  WHERE  clause. 

The  WHERE  clause  selects  those  relation  classes  that  join 
the  entities  into  a  "surrogate  entity  class"  structure. 

The  structure  is  checked  using  the  rules  found  in  the 
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CDM-1  model,  June  1983. 

Examples: 

CREATE  VIEW  SUPPLIES  DATA  ITEM  POSUM  PODATE  SUPPLIER 
LOCATION  DATADEL  REQUESTOR 

AS  SELECT  PO .  PORDERNUMBER  PO .  PORDERDATE  PO . ITEMSUPPLIER 
DL . DELI VERY_LOCATIQN  DL . DELI VERTLOCATION 
DL .  DATE  OF  DELI  VERY  MR .  REQUEST  I  *JG  SEC 

FROM  PURCHASEORDER . PO  DELI VERY. DL  MATERIAL_REQUEST . MR 

WHERE  PURCHASE  ORDER  SPECIFIES  DELIVERY  AND 
MATERI ALJREQUEST  REQUESTS  PURCHASEORDER ; 
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3.23  DEFINE  DATABASE 
Syntax: 

DEFIME  /  ORACLE  \  {  DATABASE  }  MAMED  dbnane  OM  H0ST{  IBM  } 
I  TOTAL  I  {  PCB  }  {  VAX  } 

<  IDMS  >  {  HL6  } 

I  IDS- I I  I 
I  VAX-11  I 
\  IMS  / 

VITR{  [PASSWORD  pwid  ] 

[SCHEMA  snaae  AMD  SUBSCHEMA  ss_nane  AREAS 
area_nane . . . ] 

[FILES  file  nano ...  3 

[POSITIOM  integer 1  IM  PSB  psbnane  FEEDBACK 
LENGTH  integers]}; 


Consents : 


e 

e 


e 


e 


The  database  nane  aust  be  unique. 

A  database  is  defined  for  one  of  the  following  types: 
ORACLE.  TOTAL.  IDMS.  IDS- II.  VAX-11  or  IMS. 

The  database  oreated  is  established  as  the  current 
database  until  such  tine  the  user  defines  another 
database . 

The  three  choices  of  host  are  not  aeant  to  be  exclusive. 
The  user  nay  enter  any  valid  three  character  HTM  host 
designator,  uppercase.  The  values  are  stored  and  not 
checked . 

Oracle  Database: 

DEFINE  ORACLE  DATABASE  NAMED  db_naae  ON  HOST  {  IBM  } 

{  VAX  } 

{  HL6  } 


WITH  PASSWORD  pwid; 
A  password  is  required. 


•  Total  Database: 
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DEFINE  TOTAL  DATABASE  NAMED  db_name  ON  HOST  {  IBM  } 

{  VAX  } 

{  HL6  } 

WITH  FILES  f ile_name. . .  ; 

At  least  one  file  is  required. 

•  VAX-ll/IDMS/IDS-II  database: 

DEFINE  {  VAX- 11  )  DATABASE  NAMED  db  name  OH  HOST  {  IBM  } 

{  IDMS  }  ~  {  VAX  } 

{  IDS- I I  }  {  HL6  ) 

WITH  SCHEMA  sjaame  AND  SUBSCHEMA  ssname  AREAS 
areaname 

The  soheaa ,  subschema ,  and  at  least  one  area  are  required. 

•  IMS  database : 

DEFINE  IMS  PCB  MAMED  dbname  ON  HOST  IBM  WITH  POSITION 
integer 1  IN  PSB  psbjiame  FEEDBACK  LENGTH  integer 2 

An  IMS  database  requires  the  term  'pcb' . 

The  start  position  and  feedback  length  (the  length  of  the 
fully  concatenated  key  of  the  longest  path  in  the  PCB)  are 
required. 

Examples : 

DEFINE  ORACLE  DATABASE  NAMED  0RC_DB  ON  HOST  VAX  WITH 
PASSWORD  SOS ; 

DEFINE  TOTAL  DATABASE  NAMED  T0T_DB  ON  HOST  IBM  WITH  FILES 
ITEM  LOCC  STOK  ; 

DEFINE  VAX- 11  DATABASE  NAMED  CODDB  ON  HOST  VAX  WITH 
SCHEMA  SI  AND  SUBSCHEMA  SSI  AREAS  A1  A2  ; 

DEFINE  IMS  PCB  NAMED  IMS_DB  ON  HOST  IBM  WITH  POSITION  1  IN 
PSB  SS  PSB  FEEDBACK  LENGTH  20  ; 
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3.24  DEFINE  RECORD 
Syntax: 

DEFINE  {  TABLE  }  recname  [  OF  {  DATABASE  }db_na*e] 

{  RECORD  }  {  PCB  } 

{  SEGMENT  } 

{  [IN  AREAS  areaname  ...  ] 

[SEGMENT  SIZE  integerl  ] 

/  \ 

WITH  I  FIELDS  I  f ield_name  . . . 

<  COLUMNS 
I  ELEMENTS  I 

I  ITEMS  I 

\  / 

[{START  integer2  [UNKNOWN]  }  ...  ] 

[  ACCESSED  {  BY  KEY  keyname  [(u)]  keyf ieldname 

...}  ...]}» 

Consent s : 

•  This  command  defines  a  table/ reoord/ segment  for  a 
previously  defined  database. 

•  The  “OF  DATABASE / PCB  db_name“  option  may  be  omitted  if  a 
current  database  is  established  in  the  session. 

•  A  key_f ieldnaae  must  have  been  previously  entered  as  a 
f ieldnaae . 

•  (U)  on  the  key_f ieldname  enforces  a  unique  key.  Default 
is  a  non-unique  key. 

•  This  syntax  does  not  support  repeating  groups,  component 
data  fields,  or  redefined  data  fields. 

•  Oracle  Records: 

DEFINE  TABLE  recname  [  OF  DATABASE  db_name] 

/  \ 

WITH  I  COLUMNS  I  f ield_na»e . . .  ; 

<  FIELDS 
I  ELEMENTS  I 
I  ITEMS  I 

\  / 

fieldname  is  the  only  required  option. 
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•  Total  Records : 

DEFINE  RECORD  rec_name  t  OF  DATABASE  dbjo&ae] 

/  \ 

WITH  I  FIELDS  I  f ield_name  ...  [  ACCESSED  {BY 

<  COLUMNS  > 

I  ELEMENTS  I 

I  ITEMS  I 

\  / 

KEY  key  name  [(u)3  key  field  nwe  ...}  ...]  ; 
FIELDNAME  is  required. 

ACCESSED  BY  clause  is  required  for  "MASTER"  records. 

•  VAX-1 1/IDMS/ IDS -II  Records: 

DEFINE  RECORD  recname  [  OF  DATABASE  dbname] 

/  \ 

IN  AREAS  area_name . . .  WITH  l  FIELDS  i 

<  COLUMNS  > 

I  ELEMENTS  I 

I  ITEMS  I 

\  / 

f ield_name. . .  [ACCESSED  {  BY  KEY  key_name  [(u)] 
keyf ieldname 

At  least  one  area  and  one  field  are  required. 

•  IMS  Records : 

DEFINE  SEGMENT  rec_name  [  OF  PCB  db_name] 

SEGMENT  SIZE  integerl  WITH  ELEMENTS 
f  ieldname 

START  integer2  [UNKNOWN]  ...  ; 

Segment  size  and  start  byte  information  are  required. 
Examples : 

DEFINE  TABLE  TAB  OR  OF  DATABASE  ORC  DB  WITH  COLUMNS  Cl  C2 


3-40 


UK  620141100 
1  November  1985 


C3  C4  ; 

DEFINE  RECORD  RECTOT  WITH  FIELDS  ITEMCTRL  ITEMI111 
ITEMI222  ACCESSED  B7  KEY  ITEMKEY1  (U)  ITEMCTRL  BY  KEY 
ITEMKEY2  ITEMI111  ITEM I 222  ; 

/*  assumes  a  current  TOTAL  database  has  been  established 
in  the  session  */ 

DEFINE  SEGMENT  SEG1  OF  PCB  IMS_DB  SEGMENT  SIZE  20  WITH 
ELEMENTS  SI_ID  START  1  SIQTY  START  11  ; 

DEFINE  RECORD  REC1  OF  DATABASE  CODDB  IN  AREAS  A1  A2 
WITH  FIELDS  ITEMID  ITEMQTY  ACCESSED  BY  KEY  REC1KEY1 
ITEM  ID  ; 
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3.25  DEFINE  SET 
Syntax: 


DEFINE  {  SET  } 
{  PATH  } 


[ set name]  OF  {  DATABASE  }  databasename 
{  PCB  } 


{  RELATING  }  recordidl  TO  (record_id2 
{  FROM  } 


[REQUIRED I OPTIONAL] } . . . 
[LINKED  BY  data  field  nane]  ; 


Connents : 

•  The  following  elements  must  exist  in  the  Connon  Data 
Model : 

database 
record  type 
data  field 

•  The  above  connand  is  illegal  for  an  Oracle  database. 

•  The  following  rules  govern  the  creation  of  a  set/path  for 
a  DBMS  type: 

a.  Sets  nay  be  created  for  TOTAL,  IMS  (called  paths), 
and  the  Codasyl  DBMSs:  VAX-11.  IDMS.  and  IDS. 

b.  Codasyl  DBMSs  require  an  entry  for  required/optional 
members . 

c.  TOTAL  DBMSs  require  a  linked  by  Data  Field  Name 
clause . 

d.  Single  members  are  allowed  in  all  DBMSs.  Multiple 
members  (RecordListID)  may  be  used  for  the  CODASYL 
DBMSs . 

•  DEFINE  {  SET  }  [setname]  OF  {  DATABASE  }  databasename 

{  PATH  }  {  PCB  } 

The  set  or  path  is  a  required  entry  for  TOTAL  and  CODASYL 
DBMSs.  Path  is  used  as  a  more  natural  entry  for  an  IMS 
database.  For  an  IMS  database,  if  "path"  is  used,  the  set 
name  is  derived  from  combining  the  owner  (RecordIDl)  and 
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■ember  (Record_ID2)  names. 

The  Data_Base_Name  or  pcb  is  an  optional  entry  if  a 
DataBaseName  or  pcb  has  previously  been  established 
during  the  session  using  a  define  database,  define  record, 
or  define  set  command.  The  use  of  pcb  is  more  natural  for 
an  IMS  database . 

e  {  RELATING  }  record_idl  TO  {record_id2 
{  FROM  } 

[REQUIRED (OPTIONAL] } . . . 

The  RELATING/FROM  clause  is  a  required  entry.  From  is 
■ore  natural  with  an  IMS  database.  Record_IDl  denotes  the 
owner  of  the  set  and  Record_ID2  denotes  the  member(s)  of 
the  set.  Record_ID2  is  used  for  Codasyl  DBMSs  to  show 
multiple  members  and  includes  the  member  Record  IDs 
separated  by  a  space.  The  required  or  optional  clause  may 
only  be  used  for  the  Codasyl  DBMSs.  All  other  DBMSs 
default  to  required. 

•  [LINKED  BY  data_f ield_name] 

The  LINKED  BY  clause  may  only  be  used  for  a  TOTAL  DBMS  and 
must  include  a  DataFieldName  from  the  variable  record 
(Record_ID2) . 

Examples : 

DEFINE  SET  MAYHAVE  OF  DATABASE  DB1  RELATING  CUSTOMER_REC 
TO  CUST0MER_ ACTIVITY  ; 

DEFINE  PATH  OF  PCB  DBIMS2  FROM  SUPPLIER_ACCT  TO 
SUPPLIER_INVOICE  ; 

DEFINE  SET  CONTROLLEDBY  OF  DATABASE  DBT0TAL14  RELATING 
SHOPSUPPLY  TO  SHOPREQUESTS  LINKED  BY  SH0P_N0  ; 


UM  620141100 
1  November  1985 


3.26  DESCRIBE 


Syntax: 


/  \ 

DESCRIBE  I  DEFINITION  I 

<  DESCRI PTI VEHAME  > 
I  EXAMPLE  I 

I  SOURCE  I 


[OF] 


/ 

I 


Consents 


"DESCRIPTION  TEXT" 
FROM  'file  name'  ]; 


ENTITY  ec_name  l 

ATTRIBUTE  ac_nane  > 

RELATION  ind_ec_naael I 
rename  dep_ec_name2 i 


The  following  elenents  nust  exist  in  the  Coi 
Model : 


ion  Data 


attribute 
data  item 
record  type 
view 


database 

entity 

relation 


data  field 
record  set 
user  datatype 


•  There  are  three  sources  of  descriptive  text:  the  connand 
itself,  a  named  file,  or  the  forns  text  editor.  The  third 
option  is  not  inplenented  and  will  generate  a  user  warning 
message  if  attempted. 

•  All  new  descriptive  text  will  replace  any  preexisting 
descriptive  text  for  a  particular  description  type  and 
object . 

•  To  delete  descriptive  text  from  the  model,  use  the 
describe  command  with  an  empty  description  text  string, 
e.g., 

DESCRIBE  SOURCE  OF  ENTITY  E3 

•  No  embedded  quotation  marks  may  be  entered  in  the 
description  text  string. 

•  When  using  a  file  as  the  source  of  the  descriptive  text, 
each  record  may  be  no  longer  than  80  characters.  There  is 
no  practical  limit  on  the  number' of  records.  Each 
quotation  mark  in  the  descriptive  text  from  a  file  will  be 
replaced  by  an  apostrophe. 
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•  The  description  types  can  be  anything  preloaded  in  the 
CTO. 

Examples: 

DESCRIBE  DEFINITION  OF  ATTRIBUTE  customer_address  'This  is 
the  customer  bill-to-address. ■ ; 

DESCRIBE  DESCRI PTI  VE__NAME  ENTITY  emp  info  FROM 
'empinfo.txt'; 
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3.27  DROP  ALIAS 
Syntax: 

DROP  ALIAS  {  BMTITY  eo_nane 

I  ATTRIBUTE  ac_nane  }  ; 

Consent s : 

•  The  following  eleaents  Bust  exist  in  the  Connon  Data 
Model : 

alias  for  the  entity 

-or¬ 
al  ias  for  the  attribute 

e  The  ec_naae  or  ac_naae  specified  Bust  be  an  alias  for  the 
entity  or  attribute. 

e  The  specified  alias  is  deleted. 

Exaaples : 

DROP  ALIAS  EMTITY  OUST; 

DROP  ALIAS  ATTRIBUTE  ORDMO; 
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3.28  DROP  ATTRIBUTE 
Syntax: 

DROP  ATTRIBUTE  attr ibute_nane  . . . ; 

Conents : 

•  The  following;  elements  nust  exist  in  the  Common  Data 
Model : 

model 

attribute 

•  The  attribute  is  deleted;  if  owned,  all  occurrences  of  the 
attribute  are  removed  from  owned  attribute,  attribute  use 
class,  key  class  member,  and  inherited  attribute  use 
class . 

•  The  attribute  occurrence  is  deleted  from  the  model . 

•  Those  key  class  occurrences  with  no  remaining  key  class 
members  are  deleted. 

•  If  a  key  class  is  deleted,  the  occurrence  of  a  complete 
relation  is  also  deleted. 

•  All  keywords  associated  with  the  attribute  will  be 
dropped . 

•  The  primary  name  and  all  aliases  for  the  attribute  will  be 
deleted. 

•  All  description  texts  for  the  attribute  will  be  deleted. 
Examples : 

DROP  ATTRIBUTE  PHONE  NO; 
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3.29  DROP  DATABASE 
Syntax: 

/  \ 

DROP  I  VAX-11  I  {  DATABASE  }  NAMED  dbaaie ; 

I  IDMS  I  {  PCB  ) 

I  IDS- I I  I 

<  ORACLE  > 

I  TOTAL  I 

I  IMS  I 

\  / 

Consents : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model: 

database/pcb 

•  An  IMS  database  requires  the  term  'PCB.' 

•  This  command  drops  the  database,  all  associated  record 
types,  record  sets,  data  fields,  and  mappings. 

e  If  any  of  the  data  fields  for  this  database  were  mapped  to 
the  I NTEGRATED_MODEL ,  their  mapping  will  be  dropped.  If 
it  was  a  primary  mapping,  any  secondary  mappings,  even  to 
other  databases,  will  also  be  dropped.  If  it  was  a 
secondary  mapping,  the  primary  mapping  would  not  be 
dropped . 

•  All  description  texts  for  the  database,  all  associated 
sets,  fields,  or  records  will  be  deleted. 

Examples: 

DROP  ORACLE  DATABASE  NAMED  0RC_DB; 

DROP  TOTAL  DATABASE  NAMED  T0T_DB ; 

DROP  VAX- 11  DATABASE  NAMED  C0D_DB; 

DROP  IMS  PCB  NAMED  IMS  DB; 
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3.50  PROP  DOMAIN 
Syntax: 

DROP  DOMAIN  domain_name  . . . ; 

Connents : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model : 

domain 

•  If  data  types  of  the  domain  to  be  dropped  are  associated 
with  any  project  data  fields,  data  items,  or  attribute 
classes,  the  usage  will  be  reported  and  the  domain  will 
not  be  dropped. 

•  If  the  above  condition  (2)  is  not  met,  the  data  types 
associated  with  the  domain  are  deleted,  and  the  domain 
itself  is  deleted. 

e  All  description  texts  will  be  deleted  for  the  Domain. 
Examples: 

DROP  DOMAIN  ADDRESS; 
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3.51  PROP  EMTITY 
Syntax: 

DROP  EMTITY  eo_naae  . . . ; 

Comments : 

•  The  following  elements  mist  exist  in  the  Connon  Data 
Model : 

entity 

nodel 

e  Any  owned  attribute  class  occurrences  are  deleted.  Also 
reaoved  are  attribute  use.  inherited  attribute,  key  class 
member,  and  key  classes. 

e  All  relation  classes  involving  the  entity  are  deleted,  as 
are  any  keywords  associated  wth  the  entity. 

e  The  entity  is  deleted. 

e  The  primary  naae  and  all  aliases  for  the  entity  are 
deleted. 

e  All  description  texts  for  the  entity  are  deleted. 

Exaaples: 

DROP  EMTITY  ORDER  INFO; 
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3.32  DROP  FIELD 


Syntax : 


/ 

\ 

DROP 

1 

COLUMNS 

I  field_nane 

< 

FIELDS 

> 

1 

ELEMENTS 

1 

1 

ITEMS 

1 

\ 

/ 

OF 

{ 

DATABASE 

}  db  name; 

{ 

PCB 

} 

OF  {  TABLE  }  rec  najie 
{  RECORD  } 

{  SEGMENT  } 


Consents : 


•  The  following  elenents  must  exist  in  the  Coanon  Data 
Model: 


columns/f ields/elenents/ items 
table/ record/ segment 
dat&base/pcb 

#  This  command  deletes  the  field(s)  specified,  all 
associations,  and  all  associated  mappings. 

•  If  the  data  field(s)  being  dropped  was  mapped  to  the 
INTEGRATEDMODEL ,  its  mapping  would  be  dropped.  If  it  was 
a  primary  mapping,  any  secondary  mapping,  even  to  other 
databases,  would  also  be  dropped.  If  it  is  a  secondary 
mapping,  the  primary  mapping  would  not  be  dropped. 

e  All  description  texts  of  the  data  field  will  be  deleted. 


Examples : 

DROP  COLUMNS  Cl  C2  OF  TABLE  TAB_0R  OF  DATABASE  ORCDB ; 
DROP  ELEMENTS  SI_ID  SI_QTY  OF  PCB  IMS_DB; 
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3. S3  DROP  KEYWORD 
Syntax: 

DROP  KEYWORD  key_word  . . . ; 

Couents : 

•  The  following  elements  aunt  exist  in  the  Conaon  Data 
Model : 

keyword 

e  The  keyword  reference  is  deleted  from  any  entity, 
attribute,  and  relation. 

•  The  keyword  is  deleted. 


e  MOTE: 

This  couand  will  drop  a  keyword  irrespective  of  the 
aodel . 

Examples: 

DROP  KEYWORD  KEY  ADDRESS; 
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3.54  DROP  MAP 
Syntax: 

DROP  MAP  { ecname . tagnaie 

I  indecname  rc_name  dep_ec_name) ; 


Comments : 

•  The  following  elements  must  exist  in  the  common  data 
model : 

independent  entity 
dependent  entity 
attribute  use  class 
relation  class 

•  The  map  is  deleted. 

•  Tag_name  is  a  unique  name  for  an  attribute  use  class 
within  an  entity  class. 

Examples : 

DROP  MAP  PART. SIZE; 


DROP  MAP  EMPLOYEE  POSSESSES  SKILL; 
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S.3S  DROP  MODEL 
Syntax: 

DROP  MODEL  model_name; 

Comments : 

•  Modeln&ae  nust  exist. 

•  Everything  associated  with  a  model  will  be  dropped.  This 
is:  all  entities,  owned  attributes,  attribute  use 
classes,  key  classes,  key  class  members,  inherited  attri¬ 
bute  use  classes,  relation  classes  and  oomplete  relation 
classes,  and  all  attributes.  The  descriptions,  aliases, 
and  keywords  for  the  entities,  attributes,  and  relations 
of  the  model  will  be  dropped. 

e  The  modelname  and  its  descriptions  will  be  deleted, 
e  The  integrated_model  cannot  be  dropped. 

Examples : 

DROP  MODEL  X; 
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S.36  DROP  RECORD 
Syntax: 

DROP  {  TABLE  }  rec  naie  OF  {  DATABASE  }  dbname  ; 
{  RECORD  }  {  PCB  } 

{  SEGMENT  } 

Comments : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model : 

tabl e/ record/ segment 
database /pcb 

•  This  command  deletes  the  record  specified  and  all 
associated  fields,  areas,  and  sets. 

•  If  any  of  the  datafields  for  this  record  were  mapped  to 
the  integrated_model ,  their  mapping  will  be  dropped.  If 
it  was  a  primary  mapping,  any  secondary  mapping,  even  to 
other  databases,  will  also  be  dropped.  If  it  was  a 
secondary  mapping,  the  primary  mapping  would  not  be 
dropped . 

•  All  description  texts  will  be  deleted  for  the 
record/ table/ segment  and  any  fields. 

Examples : 

DROP  TABLE  TAB_0R  OF  DATABASE  0RC_DB; 

DROP  SEGMENT  SEG1  OF  PCB  IMS  DB; 
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3.37  DROP  RELATION 
Syntax: 

DROP  RELATION  {  i ndec_na*e_ 1  rcnaae  dep_ec_nane_2  } 
Consents : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model: 

relation  class 
model 

•  If  a  key  class  had  been  migrated,  it  is  "immigrated" ; 
i.e.,  the  attribute  use  and  inherited  attributes  are 
removed  from  the  dependent  entity  and  from  any  other 
entities  to  which  they  have  migrated. 

•  The  relation  class  and  complete  relation  are  deleted  from 
the  model . 

•  The  keywords  associated  with  the  relation  are  dropped. 

•  All  description  texts  for  the  relation  are  deleted. 
Examples : 

DROP  RELATION  SALES  PERSON  MANAGES  ACCOUNT; 
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3.38  DROP  SET 
Syntax: 

DROP  {  SET  }  setnaie  OF  {  DATABASE  }  dbname ; 

{  PATH  }  {  PCB  } 

Comments : 

•  The  following  elements  must  exist  in  the  Common  Data 
Model : 

set/path 

database/pcb 

•  This  command  deletes  the  set  specified,  and  all  associated 
mappings. 

•  All  description  texts  for  the  set  will  be  deleted. 

Examples : 

DROP  SET  TEST1  OF  DATABASE  TOT  DB; 


DROP  PATH  TEST2  OF  PCB  IMS  DB; 
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3.39  DROP  VIEW 
Syntax: 

DROP  VIEW  view_nane  — 

Consents: 

•  A  valid  VIEW  must  exist  in  the  Coaaon  Data  Model. 

•  All  project  data  items  associated  with  the  view  being 
deleted  are  deleted. 

•  The  surrogate  entity  (user  view)  to  relation  nappings 
associated  with  the  view  are  deleted. 

•  All  data  items  associated  with  the  view  are  deleted. 

•  The  view  is  deleted  from  the  system. 

•  All  description  texts  for  the  view  and  data  items 
belonging  to  the  view  are  deleted. 

Examples: 

DROP  VIEW  SUPPLIES  MATERIAL  LIST  ; 
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3.40  HALT 
Syntax: 

HALT; 

Conaents : 

•  The  current  IDOL  session  will  be  terainated. 
Exaaples: 

HALT; 


V 

f  I 

rj 

A 

♦  J 

r  J 

(I 

* 

t  j 

A 
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3.41  MERGE  MODEL 


MERGE  MODEL  model_name  1  WITH  model_naae  2 
[XM70  modelname  3]  OV  FILE  'file  name' 
[EXCEPT  [DESCRIPTION]  [ALIAS]  [KEYWORD] ] ; 


e  modelnamel  end  model_name_2  must  exist. 

e  The  im<  commands  necessary  to  merge  modelnamel  and 
node 1 _name_2  are  generated  on  the  file  named.  If  the 
named  file  does  not  exist,  a  nee  file  is  created  and 
opened.  If  the  named  file  does  exist,  the  generated 
commands  are  appended  to  the  file. 

e  If  aodel_name_3  is  entered,  model_name_3  mast  not  exist. 
The  result  of  the  merge  will  create  model_name_3.  All 
attributes,  entities,  relations,  key  classes,  aliases, 
keywords,  and  descriptions  of  modelnamel  will  be 
generated  for  nodel_naae_3,  unless  exoepted.  The  output 
is  the  same  as  output  from  a  COPT  MODEL  of  modelnamel  to 
nodel_nane_5. 

e  If  nodel_nano_3  is  omitted,  the  result  of  the  merge  will 
alter  nodel_name_l . 

e  For  each  entity  in  model_nane_2,  if  the  entity  does  not 

exist  in  model_name_l ,  the  generated  commands  are  the  same 
as  the  output  of  a  COPY  ENTITY  from  mode 1 _name_2  with 
relation. 

e  For  each  entity  in  nodel_nane_2 ,  if  the  entity  does  exist 
in  modelnamel ,  the  generated  commands  are  the  same  as 
the  output  of~a  COMBINE  ENTITY  from  nodel_nane_2 . 

e  Refer  to  COMBINE  ENTITY  for  a  complete  description  of  the 
EXCEPT  clause. 

e  Generated  Comnands : 

The  generated  NDDL  commands  should  be  examined  for 
potential  run-time  errors. 

A  create/alter  entity  command  night  attempt  to  add  an 
owned  attribute  to  an  entity  when  the  attribute  is  already 
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owned  by  another  entity  in  the  target  model.  The  modeler 
must  decide  which  entity  should  own  the  attribute  and 
change  the  MDDL  accordingly. 


NOTE: 

When  an  attribute  is  added  to  an  entity  and  the  attribute 
already  exists  in  the  target  model,  a  comment  is  generated 
in  the  NDDL  command  following  the  attribute.  The  comment 
is: 

/*  ATTRIBUTE  MAT  BE  OWNED  IN  TARGET  MODEL  •/ 


Examples : 

MERGE  MODEL  IMTEGRATEDJiODEL  WITH  MODELA  ON  FILE 
' INTEGMOD . FIL ' ; 

MERGE  MODEL  MODELA  WITH  MODELB  INTO  NEWMODEL 
ON  FILE  'NEWMODEL. FIL'  EXCEPT  ALIAS  KEYWORD ; 
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3.42  REMAKE 


Syntax: 


REMAKE 


Comments 


1 

ENTITY 

ec_naaol 

TO 

ec_naae2 

1 

ATTRIBUTE 

acnwael 

TO 

ac_name2 ; 

1 

KEYWORD 

keyword 1 

TO 

keyword2 

MODEL 

modeljaamol 

TO 

mode 1 _naae2 

1 

DOMAIN 

don_naael 

TO 

dom_name2 

1 

VIEW 

vievnaael 

TO 

view_naae2 

1 

RELATION 

lndecnaael 

rc_ 

naael  dep  ec  n; 

i 

i 

\ 


TO  ind_eo_nanel  rc_nane2 
depecnaae  2 


•  The  fol lowing  eleaents  aust  exist  in  the  Coaaon  Data 
Model : 

entity  or  attribute  or  keyword  or  aodel  or 
domain  or  view  or  relation 

e  After  determining  that  the  above  eleaents  exist,  and  the 
elenent  to  be  renamed  does  not  previously  exist,  the 
object  is  updated. 

•  Rename  relation  command  requires  the  entity  class  names 
for  the  relation  class  to  be  updated. 

Examples : 

MAKE  ENTITY  INVOICE  to  ORDER; 

RENAME  RELATION  INVOICE  SUPPLIES  ORDERINFO  to 
INVOICE  DESCRIBES  ORDER  INFO; 
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APPEHDIX  A 

HDDL  COMMAND  ERROR  MESSAGES 


This  section  describes  HDDL  Command  Error  messages  that  say 
be  encountered  during  HDDL  execution.  These  error  Messages 
infora  the  user  about  error  conditions  for  the  objeot  type 
(Entity,  Attribute,  Database)  being  processed.  Por  exaaple,  the 
coaaand  “DROP  MODEL"  aay  encounter  error  messages  concerning  all 
objects  associated  with  the  model  (Entities,  Attributes, 
Relations,  etc). 

The  error  message  report  contained  in  this  section  is 
formatted  to  indicate  the  type  of  error  (warning,  error,  fatal), 
the  object  type  that  is  associated  with  the  error,  and  the 
actual  error  message  (with  the  object  indent if ioat ion)  that  will 
be  issued  during  HDDL  execution. 

The  error  types  are  categorised  as: 

FATAL  -  A  system  or  CDM  DBMS  error  that  caused  the  process  to 
fail  or  be  interrupted  and  stopped. 

ERROR  -  A  condition  that  will  not  allow  the  HDDL  command  to 
process  as  expected. 

WARRING  -  An  informational  message  issued  to  the  user  based  on 
a  nonfatal  or  nonprocess  interrupting  condition. 
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APPEMDII  B 
GLOSSARY 


Alpha-Numeric  Data  Format 

A  data  format  for  values  that  can  contain  characters  other 
than  numerals  CO-9).  Numerals  may  be  permitted  also. 


Attribute  Class 


A  collection  of  all  the  same  kind  of  attributes,  i.e., 
those  that  have  the  same  meaning.  An  attribute  is  a 
characteristic  or  fact  about  an  entity.  An  attribute  consists 
of  a  name  (e.g. ,  employee  hire  date)  and  a  value  (e.g..  15 
August  1980).  An  attribute  value  may  be: 

A.  Mondivisible  (e.g..  state  name) 

B.  Divisible,  i.e..  a  concatenation  of  two  or  more  other 
attribute  values  (e.g.,  part  number  formed  by 
concatenating  drawing  number  and  material  code). 

C.  Computed  from  one  or  more  other  attribute  values 
(e.g.,  age  computed  as  current  date  minus  birth  date). 

Attribute  Class  Data  Description 

A  generic  data  description  that  applies  to  a  particular 
attribute  class. 


Attribute  Pse  Class 


A  model  attribute  class  that  appears  in  a  model  entity 
class.  Each  attribute  use  class  represents  either  an  owned 
attribute  olass  or  an  inherited  attribute  class. 

Attribute  Ose  Class/Data  Field  Mapping 

Indicates  that  am  attribute  use  class  corresponds  to  a  data 
item;  i.e.  that  they  have  the  same  meaning  and  that  the  data 
item  can  be  used  to  acoess  the  values  for  the  attribute  use 
class . 
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Attribute  Ose  Class/Record  Set  Happing 

Certain  attribute  use  classes  can  be  represented  in  a 
database  by  a  group  of  record  sets  rather  than  be  a  data  field. 
For  exaaple.  Project: Task  record  sets  called  Pending,  In- 
Process,  On-Hold,  and  Completed.  An  attribute  use  class/record 
set  napping  indicates  that  a  particular  record  set  corresponds 
to  a  particular  attribute  use  class  value. 

Component  Data  Field 

A  data  field  that  is  part  of  another  data  field;  e.g..  if 
data  field  A  is  made  up  of  data  fields  B,  C,  and  D,  each  of 
these  latter  data  fields  is  a  component  of  A.  A  data  field 
cannot  be  a  component  of  nore  than  one  other  data  field. 

Conponent  Dona in 

An  elementary  domain  that  is  part  of  another  donain;  e.g.. 
a  Date  donain  night  be  made  up  of  a  Month  donain,  a  Day  of  Month 
donain,  and  a  Tear  donain.  Each  of  these  latter  domains  would 
be  a  conponent  of  the  Date  domain.  An  elementary  donain  can  be 
a  conponent  of  several  other  domains. 

DBD 

An  IMS  database  is  defined  by  a  Database  Description  (DBD). 
The  DBD  consists  of  statement  which  nap  an  IMS  structure  into 
physical  storage. 

Database  Area 


A  subdivision  of  a  CODASYL  database.  This  subdivision  is  a 
technique  for  inproving  the  efficiency  accessing  database  record 
type  instances.  When  a  database  is  subdivided  into  database 
areas,  some  or  all  of  its  records  types  are  assigned  to 
particular  areas.  Instances  of  these  record  types  are  stored 
only  within  the  assigned  areas.  Then,  these  record  type 
instances  can  be  accessed  by  searching  only  the  appropriate 
areas  rather  than  the  entire  database.  This  access  method  is 
only  used  when  the  record  type  instances  cannot  be  located  by 
other  means  (e.g.,  by  calc  keys  or  record  sets). 

Database  Area  Assignment 

Indicates  that  a  record  type  is  assigned  to  a  database 


area. 


UK  620141100 
1  November  1985 


Database  Directory 

A  software  library  that  must  be  used  when  accessing  a 
database. 

Database  Password 


A  code  that  must  be  supplied  when  logging  on  to  a  DBMS  to 
use  a  database.  The  DBMS  verifies  the  password  before  accepting 
any  other  Messages. 

Data  Field 


A  portion  of  a  record  type  in  which  data  values  can  be 
stored 

Data  Field/Record  Set  Linkage 

A  data  field  in  a  variable  data  set  in  a  TOTAL  database 
that  is  used  as  the  variable  control  key  for  a  1 ink path  from  a 
■aster  data  set. 

Data  Field  Redefinition 

A  data  field  that  occupies  the  sane  space  in  a  record  type 
as  another  data  field.  A  record  instance  cannot  contain  values 
in  both  data  fields.  One  instanoe  can  contain  a  value  in  one 
field  while  another  contains  a  value  in  the  other. 

Data  I ten 

An  attribute  class  as  seen  by  a  user  in  a  user  view,  i.e., 
a  kind  of  data  (e.g.,  employee  hire  date),  not  a  particular  data 
value  (e.g.,  15  August  1980). 

Data  Type 

The  combination  of  a  type  of  values  (e.g.,  alphanumeric, 
signed  numeric,  etc.)  and  a  type  of  storage  (e.g.,  binary, 
packed ,  etc . ) 

Data  Type  Mane 

Manes  of  NDDL  data  types .  The  NDDL  data  types  correspond  to 
the  following  COBOL/FORTRAN  data  types: 
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NDDL  Data  Type  COBOL /FORTRAN  Data  Type 


INTEGER 

CHARACTER 

SIGNED 

FLOAT 

UNSIGNED 

PACKED 


FORTRAN  binary  integer 
x(n) 

S99V99 

FORTRAN  floating  point 

99V99 

COMP-3 


Description  Type 

A  generic  object  may  have  several  different  kinds  or  styles 
of  description  (short,  long,  technical,  nontechnical,  etc.). 

Each  is  a  description  type. 


Domain 


A  set  of  rules  about  the  values  that  are  allowed  for  a  data 
item,  attribute  class,  or  data  field.  A  domain  is  either  an 
elementary  domain  or  a  group  of  two  or  more  elementary  domains, 
called  component  domains. 

Domain  Range 

A  series  of  consecutive  values  that  represent  all  or  part 
of  an  elementary  domain. 

Domain  Value 

A  single  value  within  an  elementary  domain. 

Elementary  Data  Field 

A  data  field  that  does  not  have  any  component  data  fields. 
Entity  Class 

A  collection  of  similar  entities,  i.e.,  those  that  have  the 
same  kinds  of  attributes.  An  entity  is  a  person,  place,  event, 
thing,  concept ,  e tc . 

Entity  Class /Record  Type  Mapping 

Indicates  that  an  entity  class  corresponds  to  a  record 
type,  i.e.,  that  they  both  have  the  sane  meaning  and  that  the 
record  type  can  be  used  to  store  instances  of  the  entity  class. 


B-4 


DM  620141100 
1  November  1985 


If  a  record  type  has  more  than  one  EC-RT  napping,  soae  of 
its  instances  correspond  to  instances  of  one  entity  class  while 
others  correspond  to  instances  of  another,  i.e..  the  record  type 
is  the  relational  union  of  the  entity  classes.  An  example  is  a 
Replenishment  Order  record  type  that  maps  to  both  the  Purchase 
Order  and  Manufacturing  Order  entity  classes.  Each  record 
instance  represents  either  a  purchase  order  or  a  manufacturing 
order. 

Feedback 


The  length  of  the  key  feedback  area  for  an  IMS  PCB.  When 
IMS  retrieved  a  segment  from  the  database,  the  requested  segment 
is  fetched  and  a  fully  concatenated  key  is  placed  in  the  key 
feedback  area.  The  fully  concatenated  key  consists  of  the 
concatenation  of  the  sequence  field  of  values  of  all  segments  in 
the  the  hierarchical  path  from  the  root  down  to  the  retrieved 
segment.  They  key  feedback  area  must  be  large  enough  to 
accommodate  the  maximum  length  for  a  fully  concatenated  key  and 
stated  in  the  KEYLEM  entry  of  the  PCB  macro. 

File 


A  set  of  stored  data  that  is  managed  by  a  file  management 
system  (e.g.,  VSAM). 

Fi le/Database 

A  set  of  stored  data,  i.e.,  either  a  computer  file  (e.g.,  a 
VSAM  or  flat  file)  or  a  database  (e.g.,  an  ORACLE  or  IMS 
database ) . 

Generic  Data  Description 

A  detailed  description  of  the  values  for  one  or  more  data 
items,  attribute  classes,  data  fields,  and/or  module  parameter. 
It  includes  format,  measurement,  and  domain  characteristics  of 
the  values. 

Generic  Data  Description  Domain 

A  domain  that  is  specified  as  part  of  a  generic  data 
description. 

Generic  Data  Description  Unit  of  Measure 


A  unit  of  measure  that  is  specified  as  part  of  a  generic 
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data  description. 
Host 


A  computer  in  the  1ISS. 

IMS  Segment 

A  record  type  in  a  database  that  is  controlled  by  IBM's  IMS 

DBMS. 

Inherited  Attribute  Class 


A  key  class  in  the  independent  entity  class  of  a  relation 
class  that  has  migrated  to  appear  in  the  dependent  entity  class 
of  that  relation  class. 

Key  Class 

A  group  of  one  or  more  of  an  entity's  attributes  that  can 
be  used  to  uniquely  identify  the  entity  within  its  entity  class. 
An  entity  can  have  more  than  one  key.  A  key  class  is  a 
collection  of  the  attribute  classes  whose  member  attributes 
comprise  the  keys  for  the  entities  in  an  entity  class.  An 
entity  class  has  the  same  number  of  key  classes  as  each  of  its 
member  entities  has  keys.  For  example,  if  each  entity  has  three 
keys,  the  entity  class  has  three  key  classes. 

Key  Class  Member 


An  attribute  use  class  that  is  part  of  a  key  class. 
Keyword 

A  word  that  has  been  designated  as  a  means  of  locating  a 
generic  object  or  a  number  of  similar  generic  objects. 

Model 


A  representation  of  the  information  requirements  of  all  or 
part  of  an  enterprise  in  terms  of  entity  classes,  relation 
classes,  and  attribute  classes. 

Object  Type 

Sets  of  attributes  are,  in  relational  terms,  called 
objects.  Objects  participate  in  relationships  with  other 
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objects.  Entities  within  the  Common  Data  Model  (see  Generic 
Object  in  the  CDM1  Doc.  Control  No.  CCS620141000)  are  called 
OBJECT  TYPES  for  the  Integrated  Information  Support  System. 

Owned  Attribute  Class 

A  model  attribute  class  that  appears  as  an  attribute  use 
class  in  a  model  entity  class  and  is  not  an  inherited  attribute 
class . 

Program  Control  Block 

A  portion  of  a  PSB  that  describes  and  controls  how  an  IMS 
database  can  be  accessed . 

Program  Specification  Block 

A  group  of  logical  views  of  IMS  databases  that  is  used  for 
interacting  with  the  IMS  DBMS. 

Record  Set 

An  association  between  one  record  type,  called  the  owner, 
and  one  or  more  other  record  types,  called  the  members. 

Record  Set  Member 


A  record  type  that  i s  a  member  of  a  record  set . 

Record  Type 

A  group  of  data  values  that  are  stored  together  as  a  unit 
in  a  computer  file  or  database.  A  record  type  is  the  collection 
of  all  the  records  of  the  same  kind,  i.e.,  all  the  records  that 
contain  the  same  kind  of  data  values. 

Re 1 ation  Class 


An  association  between  an  entity  in  one  entity  class  and 
one  in  another.  A  relationship  has  a  label  that  describes  the 
association.  For  example,  a  customer  named  ABC  Corp.  is 
associated  with  an  order  numbered  123  in  a  manner  labeled 
"placed".  A  relation  class  is  a  collection  of  the  identically 
labeled  relationships  between  the  members  of  the  same  two  entity 
classes.  Each  relation  class  is  either  specific  or 
non-specific . 
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In  &  specific  relation  olass,  one  entity  class  is 
" independent •  while  the  other  is  "dependent";  i.e.,  entities  in 
the  first  can  exist  without  being  associated  with  any  in  the 
second,  but  those  in  the  second  cannot  exist  without  being 
associated  with  one  in  the  first.  One  key  class  from  the 
independent  entity  class  "Migrates"  through  each  speoific 
relation  class  to  appear  in  the  dependent  entity  olass  as 
inherited  attribute  classes. 

In  an  nonspecific  relation  class,  neither  entity  class  is 
dependent  on  the  other;  i.e.,  entities  in  either  entity  olass 
can  exist  without  being  associated  with  any  in  the  other.  For 
convenience,  one  entity  class  is  arbitrarily  oal led 
"independent"  and  the  other  is  called  "dependent". 

Segment  Data  Field 

A  data  field  is  an  IMS  segment. 

Subschema 

The  description,  in  the  DDL  of  a  CODAS YL  DBMS,  of  all  or 
part  of  a  database.  For  I1SS,  only  one  subschema  is  needed  for 
a  CODASYL  database,  and  it  Must  describe  all  the  common  data 
within  the  database  that  is  to  be  accessible  with  NDML . 

Tag  Mane 

A  unique  naae  for  an  attribute  use  class  within  an  entity 
class . 

Unit  of  Measure 

A  standard  scale  for  deternining  the  nagnitude  of 
sonething.  Examples  include  inch,  foot,  foot-inoh,  aeter, 
ounce,  pound,  hour,  minute,  second,  etc. 

Oser  View 

A  group  of  data  items  that  a  user  wants  to  deal  with  as  a 
group.  It  is  similar  to  an  entity  class  but  does  not 
necessarily  meet  all  the  conditions  for  being  one.  it  can  be 
thought  of  as  an  unnormalised  entity  class.  A  user  view  is 
often  the  result  of  combining  several  entity  classes  via 
relational  Join  operations  and  selecting  particular  attribute 
use  classes  as  data  items  via  relational  project  operations. 
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APPENDIX  C 

l  REFERENCES 

)  Related  I CAM  Documents  included: 


DM62014100 

COM  Administrator's  Manual 

TBM620141000 

CDM1 .  An  IDEF1  Model  of  the  Common  Data  Model 

PRM620141200 

Embedded  MDML  Programmer ' s  Reference  Manual 

DM620141002 

IGAM  Definition  Method  for  Data  Modeling  (IDEF1 
-  Extended) 

D8620141200 

Development  Specification  for  the  IISS  MDML 
Precompiler  Configuration  Item 

DS620141320 

Development  Specification  for  the  IISS 
Aggregator  Configuration  Item 

DS620141310 

Development  Specification  for  the  IISS 
Distributed  Recruest  Supervisor  Configuration 
Item 
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